REGULUS 


SYSTEM ADMINISTRATOR MANUAL 


NOTICE 


All information herein is subject to periodic updates. 
Inquiries concerning this manual should be directed to CIE 
Systems, Inc. 


ACCOUNTANT/68@ is a Trademark of CIE Systems, Inc. 
CIES 688 is a Trademark of CIE Systems, Inc. 

CNIX 1S a Trademark of CIE Systems, Inc. 

LEX/68@ is a Trademark of ACE Microsystems Ltd. 

PRO-IV is a Trademark of Data Technical Analysts, Inc. 
REGULUS is a Trademark of Alcyon Corporation. 
ULTRACALC is a Trademark of Olympus Software. 

UNIX is a Trademark of Bell Labortories. 


Copyright © 1984 by CIE Systems, Inc. Printed in the United 
States of America. All rights reserved. Without written 
permission, no part of this work covered by copyright hereon 
may be reproduced or copied in any form or by any means: 
graphic, electronic, or mechanical, including photocopying, 
recording, taping, or information and retrieval systems. 
Written permission must be granted by: 


CIE SYSTEMS, INC. 
2515 McCABE WAY 

IRVINE, CA 92713 
(714) 668-1800 


_ CIE SYSTEMS REGULUS il SYSTEM ADMINISTRATOR'S MANUAL 


~ REVISION RECORD 


PUBLICATION 
NUMBER 


6DRA-G019-880 


CIE SYSTEMS REGULUS 


DESCRIPTION 


Initial Release 


DATE 


11/84 


SYSTEM ADMINISTRATOR'S MANUAL 


LIST OF EFFECTIVE PAGES 


Subsequent changes to this manual (additions, deletions, 
changes) will be detailed by page number and listed below. 


PAGE REVISION PAGE REVISION 
Original 
11/84 

Title . 


1i through xvii " 
1-1 through 1-6 " 
2~1 through 2-9 "™ 
3~1 through 3-42 " 
4~] through 4-17 " 
5-1 through 5-22 " 
6-1 through 6-18 " 
7~l through 7-56 " 
C~l through Cc-14 " 
D~1l through D-1¢d "™ 
E~1 through E-6 " 
F~l through F-6 " 
G~l through G8 " 
H~l through H-5 " 
I~l through I-ll " 


CIE SYSTEMS REGULUS iv SYSTEM ADMINISTRATOR'S MANUAL 


PREFACE 


This manual is intended for use by REGULUS system 
administrators (i.e., individuals who have been given the 
responsibility of managing, maintaining, and operating their 
REGULUS CIES 6898 systems). 


The information needed to perform system administrator duties 
effectively and efficiently is provided in this document. 


The sections provide system overviews as well as step~by~step 
instructions for preoperational tasks, daily duties, periodic 
Maintenance, and special procedures. 


Appendices provide the additional information necessary for 
maximum use of your systen. 
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Section 1 
INTRODUCTION 


1.1 INTRODUCTION 


CIES 688 business computers combined with REGULUS system 
software are powerful tools designed to meet your data 
processing and office business needs. 


As with any other tool, your system will be fully effective 
only 1f£ properly maintained and operated. We recommend one 
individual have the responsibility of managing your system. 
This manual refers to that individual as the SYSTEM 
ADMINISTRATOR. 


The purpose of the REGULUS System Administrator's Manual is to 


Supply the system administrator with the information needed to 
effectively and efficiently perform duties. 
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1.2 CONTENTS OF THE REGULUS SYSTEM ADMINISTRATOR'S MANUAL 


This manual discusses system hardware and software, system 
administrator duties, and procedures. Appendices provide the 
additional information necessary for maximum use of your CIES 
688 system. 


@ Section 1, Introduction - provides a statement of 
‘purpose, summary of each section, and explains 
manual syntax. 


@ Section 2, Hardware Overview - describes the 
components that make up a CIES 68@ system. 


@ Section 3, REGULUS Overview - describes the 
REGULUS operating system. 


@® Section 4, Preoperational Tasks — discusses tasks 
you should perform before using your system on a 
daily basis. 


@® Section 5, Daily Duties - explains the daily 
procedures which maintain your system effectively. 


@® Section 6, Periodic Maintenance - discusses 
necessary periodic maintenance procedures. 


@ Section 7, Special Procedures - explains 
occasional system administrator tasks that you may 
need to perform. 


@ Appendix A, Glossary - is a glossary of terms. To 
be available soon. 


@ Appendix B, REGULUS Error Messages - provides the 
meaning and appropriate system administrator 
action for REGULUS error messages. To be 
available soon. 


@ Appendix C, Using the Line Editor and ed - 
discusses how to use the REGULUS line editor and 
and the ed program. 


@ Appendix D, On-Line Documentation - describes how 
to use the on-line help program. 


@ Appendix E, The /etc/passwd File - discusses some 
important aspects of the /etc/passwd file. 


@ Appendix F, Setting an Environment - explains how 
to change a user's environment. 
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—~ 
@ Appendix G, Some Important Features of the Shell, 
discusses some important aspects of the REGULUS 
shell. 
@ Appendix H, The Self Boot Diskette - discusses the 
use and care of the Self Boot Diskette. 
@ Appendix I, Index - is an index of the material 
covered in this manual. 
1.3 MANUAL SYNTAX 
This manual uses the following syntax: 
Syntactical Elements Meaning 
Press < > Press the terminal key 
indicated inside the brackets. 
we | Types Type the characters 


immediately following. 


Leave one blank space with the 
space bar. 


Indicates items in an 
unordered list. 


Indicates the order of items 
in a procedural list. 
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1.4 USING THE REGULUS SYSTEM ADMINISTRATOR'S MANUAL 


1.4.1 The REGULUS System Administrator's Binders 


CIE Systems sends out TWO REGULUS System Administrator's 
Manual binders. 


The first binder includes: 
| ® The REGULUS System Administrator's Manual 


@ A tab for you to keep Shutdown Status Sheets 
(see Section 5) 


@® A tab to keep Release Notes 


The send binder includes: 


@ Tabs for you to add documents such as 
Stand-Alone Instruction Guides, OPENFIRST 
documents, Installation Procedures, Operator's 
Guides, Trouble Shooting Guides, and other 
pertinent documents 


These binders provides you with a place to keep all system 
administrator information. 


It is very important to maintain the binders by keeping 
the Shutdown Status Sheets and periodic maintenance 
records. This is the most effective way to watch for 
potential problems or track existing ones. 
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1.4.2 Descriptive Information Ratings 


Although most of the information provided in this manual 
is procedural, some of it is descriptive. For example, 
Section 2 and 3 give a descriptive overview of your 
hardware and system software. The descriptive information 
is rated in terms of its importance to the performance of 
system administrator duties: 


@ ESSENTIAL - what a system administrator MUST 
know to perform daily tasks 


@ IMPORTANT — what a system administrator should 
know to perform regular maintenance functions 


@ RECOMMENDED - what a system administrator 
might use to take fuller advantage of REGULUS' 
features 


@® OPTIONAL - what a system administrator might 
wish to learn 


Each descriptive subsection is marked with one of these 


ratings so you may skip subsections which are not of 
interest. 


1.4.3 Using On-Line Documentation 
Throughout this manual, you are referred to on-line 
documentation for more information about a topic. The 
references look like: 

See on-line documentation under dir (amnd). 
To display on-line documentation on your screen: 


Type: help dir annd 


Press <RETURN> 
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1.5 RELATED DOCUMENTS 


The following documents provide related information about 
REGULUS and your CIES 68@ system. 


@ REGULUS Reference Manual (on-line) - You may print 
Out the Reference Manual using the makemanual 
command. For instructions, see Appendix D. 


@ REGULUS Quick Reference Canmmand Summary 
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2.1 INTRODUCTION 

To use the CIES 688 system to its full advantage, the REGULUS 
system administrator must have a basic understanding of the 
system hardware. This section provides a hardware overview. 
CIES 688 systems make possible a variety of system 
configurations with the use of modular component groups. The 
module groups that make up CIES 688 systems are: 


Section 
Number Topic 


2.2 System modules 
250 Peripherals 
2.4 Controllers 
Zim Power supply 


2.6 System enclosures and cabinets 
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2.2 SYSTEM MODULES (RECOMMENDED) 
System modules form the heart of a CIES 680 system. They 
include: 
®  68090-based Central Processing Unit (CPU) 
® Memory modules 
2.2.1 The Central Processing Unit (CPU) (RECOMMENDED) 
The CPU controls all of the processing and decision 
making. It interprets and executes the instructions 
provided by computer programs. Figure 2-1 illustrates CPU 
operation. 
je 


PROGRAMS c> : 


DATA 


SYSTEM 
INSTRUCTIONS 


Figure 2-1. The Central Processing Unit (CPU). 
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The 680/100 and 680/209 CPU is different than the CPU on 
the other CIES systems. It is referred to as the LBX 
(local bus exchange). 


2.2.2 Memory Modules (RECOMMENDED) 

Memory modules are temporary storage devices, They 
contain both the programs and the data the programs need, 
The information in memory can be lost through power 
Surges, power failures, or system failures. 

The 688/180 and 682/200 come with memory modules which can 
hold about 512 thousand characters (512 kilobytes). Other 


CIES systems' memory modules hold about 256 thousand 
characters. 


2.3 PERIPHERALS (IMPORTANT) 
Peripherals include: 

® Terminals 

® System console 

@ Hard disk drives 

@ Diskette drives 

@ Streamer tape drives 

® Magnetic tape drives 

@® Matrix line printers 

@® Letter quality printers 


Table 2-1 lists peripheral information for each CIES 68¢@ 
system. 
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Section 2, Hardware Overview 


2.3.1 Terminals (IMPORTANT) 


Terminals allow communication between the user and the 
computer. The Video Display Unit (VDU) screen displays 
requests for input and information about computer 
activities. Data and information are sent to the system 
via the keyboard. The maximum number of terminals depends 
on your system configuration. 


2.3.2 System Console (ESSENTIAL) 


The system console is the "main" terminal. In addition to 
performing all the functions of a regular terminal, 
certain procedures (such as software installation, system 
Start up and shut down) should only be performed from the 
System console. Each CIES 688 system requires one 
console. 


2.3.3 Hard Disk Drives (IMPORTANT) 


Hard disk drives are permanent, mass storage devices where 
data and programs that have been input or generated by the 
system are stored. Data are read from, or written to, the 
hard disk in thousandths of a second. There are three 
kinds of hard disks available on CIES 68@ systems. See 
Table 2-2 below. 


Table 2-2. CIES 68@ Hard Disks. 


Model Number Disk Capacity Disk Name 
680/20 1Q@MB NPL 

580/ 30-14 1@MB NPL 
680/30-46 46NB Atasi 
686/35 84MB SMD-Fujitsu 
689/ 4G 84MB SMD-Fujitsu 
SEC@/ 100 46MB Atasi 

5680/ 20@ 84MB SMD-Fujitsu 


All of the CIES 68@ hard disks are Winchester-technology 


disks, which means they are environmentally sealed inside 
the drive. 
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A hard disk is actually a stack of several disks called 
platters. Each platter is read to, or written from, by a 
head (which is similar to a phonograph needle). Each 
platter has a concentric series of rings called tracks. 
Each track is divided into sectors. Cylinders can be 
thought of as a stack of tracks in three-dimensions: a 
cylinder is all the surfaces of one particular track. 
Figure 2-2 illustrates a hard disk. 


TRACK 
SURFACE 


PLATTER 


CYLINDER 


Figure 2-2. A Hard Disk. 


same of the cylinders are allocated as swap space. This 
area 1S reserved for memory overflow. (Section 3.5.3.1 | 
covers swap space in more detail.) 


2.3.4 Diskette Drives (ESSENTIAL) 


The diskette drive is another permanent storage device. 
Diskettes are made of mylar, much like sound recording 
tape, on which information is recorded by magnetic 
impulses. Information is written to, or read from, the 
diskette by read/write heads. The diskette drive is used 
for making backup copies of data on your hard disk and for 
copying programs and information to the hard disk. 


CIE SYSTEMS REGULUS : 2-6 SYSTEM ADMINISTRATOR'S MANUAL 


~ 


Section 2, Hardware Overview 


2.3.5 Streamer Tape Drive (IMPORTANT) 


The streamer tape drive is another permanent storage 
device. Each cartridge tape stores approximately 20 
million characters (28 megabytes) of information. 


2.3.6 Magnetic Tape Drive (OPTIONAL) 


Magnetic tape drives are also permanent storage devices. 
Each reel tape holds about 1,6@@ characters per inch. A 
1.5 mil tape stores up to 46 million characters (46 
megabytes) . 


2.3.7 Letter Quality Printers (RECOMMENDED) 


Letter quality printers produce typewriter quality print. 
They use a daisy-wheel element which rotates to strike 
each character separately. This type of printer is 
relatively slow, printing one character at a time. 


2.3.8 Matrix Line Printers (RECOMMENDED) 


Matrix line printers print characters by producing a 
series of dots to form each character. These print one 
character at one time quickly and reliably. 


2.4 CONTROLLERS (OPTIONAL) 


Controllers interface between the CPU and the peripherals. 
That is, controllers allow the CPU to communicate with the 
peripheral devices described above. The number and types of 
controllers are determined by your system configuration. 
Figure 2-3 illustrates controller operation. 
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a 
PERIPHERAL } CONTROLLER 
Figure 2-3. Controllers. 
CIES 688 controllers include: 
@® cbc (Central Data Corporation) - communication ore 


@ Asynchronous communication 
@ DSD (Data Systems Design, Inc.) - diskette drive, 


1@MB and 46MB hard disk drives, streamer tape 
drive 


@ SMD (Storage Module Device) — 84MB hard disk 
drive 


@ Magnetic tape drive 


@ DMA printer (Direct Memory Access) 


2.4.1 CDC Controllers (OPTIONAL) 
CDC controllers provide a means for a flow of 


communication among the system console, terminals, modems, 
and serial printers. There are eight ports on this board. 


2.4.2 Asynchronous Communication Controllers (OPTIONAL) 


Asynchronous communication controllers provide 
communication like CDC boards, but they have four ports. 
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2.4.3 DSD Controllers (OPTIONAL) 
DSD controllers interface between the CPU and the diskette 


drive, the streamer tape drive, and the two smaller types 
of hard disk. 


2.4.4 SMD Controller (OPTIONAL) 


The SMD controller communicates with the largest CIES 68¢ 
hard disk, the 84 megabyte SMD-Fujitsu drive. 


2.4.5 Magnetic Tape Drive Controller (OPTIONAL) 


The magnetic tape drive controller interfaces with the 
magnetic tape drive. 


2.4.6 DMA Printer Controller (OPTIONAL ) 


The DMA printer controller interfaces with printers which 
print 308 or more lines per minute. 


2.5 POWER SUPPLY (OPTIONAL) 


CIES 688 power supplies are designed to match the maximum 
System power requirements for your system configuration. 


2.6 SYSTEM ENCLOSURES AND CABINETS (RECOMMENDED ) 


The main system enclosure houses the CPU and all controllers. 
Peripheral devices are housed in either the main or peripheral 
enclosure, depending on the system configuration. See Table 
2-1 for enclosure information. 


CIE SYSTEMS REGULUS | 2-9 SYSTEM ADMINISTRATOR'S MANUAL 


Section 3 
REGULUS OVERVIEW 


3.1 INTRODUCTION 

To use the CIES 688 system efficiently and effectively, the 
REGULUS system administrator must have a basic understanding 
of the system software - REGULUS. 

The discussion of the REGULUS system software is more detailed 
than the hardware discussion because most system administrator 
duties involve using and manipulating REGULUS. 

REGULUS is a UNIX-like operating system which runs on CIES 689 
computers. This section is an introduction to REGULUS and its 
major features. The following information is discussed in 
this section: 


Section 
Number Topic 


Jee The REGULUS operating system 
| The REGULUS file system 

3.4 System protection 

360 REGULUS memory 

3.6 Processes 

347 Environments 

3.8 The shell 


359 Important REGULUS files 
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3.2 THE REGULUS OPERATING SYSTEM (ESSENTIAL) | 
An operating system is an integrated series of programs that 
manages and coordinates the activities of a computer system 
including hardware (physical components) and application 
software (programs which perform a business function such as 
accounting or word processing). 
An operating system controls how your application programs use 
your system. It schedules activities and sets priorities. 
You can use REGULUS to: 
e Run multiple users on the system simultaneously 
@ Perform several different tasks for an individual 
user Simultaneously 
@ Manage the system's files without user input 
@ Respond quickly and interactively to your requests 
3.2.1 CIES REGULUS (ESSENTIAL) P— 
Because of the power and complexity of REGULUS, CIE 
Systems packages REGULUS in four different sets of 
diskettes. They are listed in Table 3-1. 
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Table 3-1. CIES 688 REGULUS Products. 


Set Contents 


REGULUS Kernel 
Diskettes B. CC, and D =< REGULUS 


kernel, sheil» and essential utilities 


REGULUS REGULUS utility programs 
Utilities 


REGULUS On-line help documentation 
Documentation 


CNIX Utilities UNIX utilities 
(Optional) 


NOTE 
The Business Solutions Package (BSP) and the Medical 


Solutions Package (MSP) are sold with only the REGULUS 
kernel set. 


3.2.2 The Kernel, Shell, and Utilities (ESSENTIAL) 


REGULUS (and UNIX) is often described as having three 
parts: 


& Kernel 
@ Shell 


@ Utilities 
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Figure 3-1 is a logical representation of REGULUS' three 
parts. 


KERNEL: MANAGES AND 
COORDINATES TASKS 


SHELL: COMMAND 


AND SHELL 
SCRIPT INTERPRETER 
KERNEL 


UTILITIES: COMMANDS 
AND MAINTENANCE 
FUNCTIONS 


UTILITIES 


Figure 3-1. The REGULUS Operating System. 


3.2.2.1 The Kernel (ESSENTIAL) 


The kernel is the heart of REGULUS. It manages the 
file system and coordinates system-initiated and 
user-initiated tasks. The kernel is the file /regulus 
in the root (/) directory and is one of the programs 
included in diskettes B, C, and D of the REGULUS 
kernel set along with essential utilities. 
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NOTE 


REGULUS is the name of the entire set of programs that 
make up the operating system. Do not confuse it with 

the single program /regulus that is the kernel program 
of REGULUS. 


3.2.2.2 The Shell (ESSENTIAL) 


This is one of the most powerful features of REGULUS. 
There are two important aspects of the shell: 


e@ COMMAND INTERPRETER: This prompts you for 
a command and then analyzes and executes 
the appropriate task. 


@ SHELL SCRIPT INTERPRETER: This lets you 
design a series of tasks to be performed 
automatically. 


It is the shell which calls programs from the disk and 
executes them. The shell is program /bin/sh and is 
included in diskettes B, C, and D of the REGULUS 
kernel set. 


3.2.2.3 REGULUS Utilities (ESSENTIAL) 


Utilities are commands and maintenance functions which 
add versatility to the system. 


REGULUS utilities provide: 

@e System, user, and file information 

@ File processing and editing 
The utilities on the REGULUS utilities set are not 
essential to REGULUS' operation (as are the kernel and 


the shell) and are packaged separately. (BSP and MSP 
are installed without the REGULUS utilities set.) 
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3.3 THE REGULUS FILE SYSTEM (ESSENTIAL) 


The REGULUS file system is hierarchically structured. It is 
often called a tree-structured file system because of the way 
its components are branched. Its components include: 


@ Directories 

e Subdirectories 
® Files 

e@ Blocks 


DIRECTORIES are the largest organizational units in 
the REGULUS file system. Think of them as locations 
(or branches) in the REGULUS tree. They contain (or 
support the smaller branches of) subdirectories and 
files. The root directory (/) is the most important 
REGULUS directory; it supports the entire REGULUS file 
system. Any directory may have subdirectories. 


SUBDIRECTORIES are directories contained in other 
directories. Thinking of a tree, subdirectories are 
smaller branches Supported by larger branches. The 
only directory that is not technically a subdirectory 
1s the root directory (/). 


FILES are the units in which information is stored, 
modified, and retrieved. Files are found in both 
directories and subdirectories. 


BLOCKS are the fundamental units of files. A block is 


the amount of information that is read from, or 
written to, the hard disk at one time. In REGULUS, a 
block is defined as a fixed amount (512 characters) of 
data. 
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The REGULUS file system is really an UPSIDE-DOWN 
tree~structure. As system administrator, you must understand 
REGULUS’ top down organization: 


1, The root directory (/) 

2. Other REGULUS directories - subdirectories of (/) 

3. Subdirectories 

4, Files 
The root directory (/) is like an upside down tree trunk; it 
Supports the rest of the tree. The major branches correspond 
to the REGULUS directories which are offshoots of root. The 
major branches support smaller branches which are similar to 
subdirectories. The leaves of the tree are like REGULUS 


files. 


Figure 3-2 illustrates REGULUS' tree structure. 
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PRINT FILES 
Rie / Loox 
av of baw . 
——@ 
—__} CMNd paee™ 
lib SL usr 
dev F 4 ~ SSX 
) man 
sr 
: doc 
Legend root DIRECTORY 
ON-LINE | 
| DOCUMENTATION | 
FILES 
Figure 3~2. REGULUS' Tree Structure. _ 
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3.3.1 The root Directory (/) (ESSENTIAL) 


The root directory (/) encompasses all programs and data 
on your system. Since REGULUS has an upside-down tree 
structure, root is the "highest" directory in the file 
system tree. To display the contents of root: 


Type: dir / 

Press <RETURN> 
REGULUS maintains and uses the programs and data in the 
root directory and the major branch directories supported 


by root (see Figure 3-2). These directories are discussed 
in 3.3.4. 


3.3.2 Path Names (IMPORTANT) 


PATH NAMES are identifiers. They identify directories, 
Subdirectories, and files by indicating the branching that 
is followed to locate them. A full path name always 
begins with the root directory symbol (/). Thereafter, 
the names of the directories are listed in order, each 
Separated by a (/). The last element in the path name is 
the local name of the file, subdirectory, or directory. 
The full path names of some of the directories and files 
shown in Figure 3-2 are given in Figure 3-3. 


NOTE 
The symbol (/) denotes two different things: 
@e A symbol for the root directory 
@® A separator used in path names 


If a path name does not begin with a (/), it is not a full 
path name and only refers to the directory you are in. 


NOTE 


Being “in" a directory means you can access the 
subdirectories and files in that directory without using 
full path names. 
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Full Path Name 
/ 
root directory 
/bin 
tot bin directory 
: root directory 
/ete 
/usr 
/lib 
/dev 
/tmp 
/doc 
/doc/man/cmnd/dir 
ee po obo4 dir file 
rn rot separator a, 
a oe oe : cmnd subdirectory 
ee separator | 
man subdirectory 
Poa separator 
1 ot doc directory 
root directory 
/usr/spool 
/usr/bin 
/usr/spool/|ip 
Dott 1 4 Ipr subdirectory 
Dott } separator 
Pott spool subdirectory 
rot separator 
» 4 usr directory 
‘ root directory 

Figure 3-3. Examples cf Full Path Names. 

a a 
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NOTE 


Notice that in Figure 3-3 you cannot tell if the last item 
in a full path name is a directory or file. REGULUS 
considers a directory a type of file. To see which items 
are directories and which are text or data files ina 


particular directory, use the dir (display directory) 
command : 


Type: dir directoryname 
Press <RETURN> 


You can always specify a file's full path name. But, 
Since the REGULUS file system may have any number of 
levels of subdirectories, using full path names becomes 
inconvenient. REGULUS avoids this problen, by assuming 
that any path name that does not begin with (/) belongs to 
the directory you are presently in. This directory is 
called your present working directory (pwd). To display 
the full path name of your present working directory: 


Type: pwd 
Press <RETURN> 


You may change your present working directory (i.e., go to 
another directory) as long as you have permission to go to 
the specified directory. (See 7.9 and on-line 
documentation under chmod (annd) for information about 
directory protection.) To illustrate, we will use examples 
from Figure 3-3. If your present working directory is 
/usr/spool, you can go to the /usr directory by using the 
cd (change directory) command: 


Type: cd /usr 
Press <RETURN> 


To display the contents of /usr, use the dir command. 
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NOTE 


Entering dir without any directory name displays the 
contents of the present working directory. 


You may specify any file or directory in your present 
working directory by using the local file or directory 
name. For example, if your present directory is /usr, you 
may display the contents of /usr/bin by: 


Type: dir bin 
Press <RETURN> 
If, however, your present directory is /lib, you must 


specify the full path name to display the contents of 
/usr/bins 


Type: dir /usr/bin 


Press <RETURN> 


3.3.3 Linking Files (RECOMMENDED) 


Linking is a REGULUS feature which allows one file to have 
more than one path name. A link may have the same local 
name as the original file if it is NOT in the same 
directory. 


Linking a file gives the file an additional path name. It 
does NOT copy, duplicate, or move the file. 


There 1S no practical limit to the number of links a file 
has. Once you create a link, the link is identical in all 
aspects to the original file. 


Links are often used to make a file accessible in more 
than one directory without making a copy of the file. 
This minimizes the amount of used space in your file 
System since you have only ONE file, but that file has 
more than one name. 
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Use the link command to make a link. For example, some of 
REGULUS' command names are linked to the same file. The 
following shows how the link and lin commands were linked 
to give the program two names: 


Type: link /bin/link /bin/l1n 
Press <RETURN> 


To remove a link (1.e., to eliminate one of the names for 
a file), use the rm conmand specifying the path name you 
wish to remove. 


See the on-line documentation under link (cmnd) for 
details about linking. 


3.3.4 REGULUS Directories and Subdirectories (ESSENTIAL) 


REGULUS requires several directories and subdirectories 
for its own use. These are created when you install 
REGULUS (i.e., at system initialization). Figure 3-4 
shows the directories and subdirectories REGULUS uses and 
briefly describes each one. 


You may wish to look at the contents of the directories in 
Figure 3-4. Use the dir command, specifying the directory 
name. Here are two examples: 


Type: dir / 


Press <RETURN> 


Type: dir /usr/spool 


Press <RETURND> 
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3.3.5 File Types Under REGULUS (IMPORTANT) 


There are four types of REGULUS files. Each type is 
identified when using the dir command as shown below: 


Table 3-2. Types of REGULUS Files. 


FILE SYMBOL EXAMPLE 


Plain No Symbol draft.let 
Executable { } {hellos} 
Directory C J Cacct ] 


Special # (*#) lpr 


The ls (list) command with the -1 option shows more 
detailed information about a directory's contents. To run 
ls -1 on your present working directory: 


Type: ls -l 
Press <RETURN> 


Figure 3-5 is an explanation of ls -1 output. 


d rwx r-x r-x gerry 2 wed Feb 9 13:10 1983 48 /usr/gerry 


owner’s access ' ‘ i H date of last access 
rights i H H ’ to this file ‘ 
‘ H H ‘ gize in 


group’s access : ‘ : bytes 
rights i i ' 


: i number of Linke to this 
all other’s access H file 
owner 


Figure 3-5. An 1s -1 Line. 
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Figures 3-6 and 3-7 show the contents of the directory 
/usr/gerry by 1s -1 and dir. 


subdirectory drwxr-xr-x root 2 Thu Aug 23 19:17 1984 2384 acct 


subdirectory drwxr-xr-x root 2 Mon Jul 16 11:25 1984 384 corres 
plain —rw-r--r-- root 1 Wed Aug 22 17:03 1984 15 draft.let 
executable ~rwxr-xr-x root 1 Wed Apr 25 12:39 1984 248 hellos 


Figure 3-6. 1s -1 of /usr/gerry. 


Directory /usr/gerry 


Cacct ] {corres ] draft.let {hellos} 


: Figure 3-7. dir of /usr/gerry. | 


3.3.5.1 Plain Files (RECOMMENDED) 


A plain file can be read from or written to, but oo" 
cannot be executed. Plain files are usually text 
files or program data. 


3.3.5.2 Executable Files (RECOMMENDED) 


An executable file 1s either a program or a shell 
script (a file containing REGULUS commands). REGULUS 
commands and maintenance functions are examples of 
executable files. If you write your own executable 
files, you must make sure you have permission to 
execute it. (See 7.9 and on-line documentation under 
chmod (cmnd) .) 
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3.3.5.3 Directory Files (RECOMMENDED) 


A directory is considered a type of file. For other 
types of files, write-permission means you can change 
the contents of a file. For a directory, 
write-permission means files can be added to or 
deleted from that directory. Directories must have 
execute permission to be searchable. (See 7.9 and 
3.4.3 for file permissions discussions.) 


3.3.5.4 Special Files (RECOMMENDED) 


‘Each special file is associated with an input/output 


(I/O) device. That is, there are special files for 
terminals, hard disk drives, diskette drives, 


printers, streamer tape drives, and communication 
lines. Special files are found only in the /dev 
directory. There are two types of special files: 


@ Block special files 

@ Character special files 
The block or character type denotes how information is 
transmitted to or from REGULUS: block-by—block or 


character-by-character. To see how these are 
distinguished, use the ls (list) command: 


Type: ls -l /dev 
Press <RETURN> 


The "b" and "c" characters in the first column of each 
line designate the special file type. 


Figure 3-8 is an example of an ls -l on the /dev 
directory. 


See 7.13.4 for a discussion of the major and minor 
numbers that appear immediately before the last column 
in a ls -l of /dev. 
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cCrw-rw-ry- 
bru-rw-ry- 
Ccra-rTra-roe- 
Cra-ryu-ru- 
Crwu-rw-run 
cru-ru-rw- 
cru-rw-rw- 
bru-ru-r-— 


Thu Aug 30 14:59 
Non Jul 16 11:25 
Thu Aug 30 16:62 
Thu Aug 30 16:02 
Ved Mar 28 16:31 
Wed Aug 29 23:67 
Thu Aug 30 11:07 
Thu Aug 38 07:53 


Crw-rw-rw- 
Crw--w--w- 
CrW--W-—-Vv- 
Crw--W--w- 
Crw--W--wW- 
Crw--W--w- 
crw-—-w--w- 
crw-rw-rw- 
Crw--w--w- 
brw-rw-rw- 


Fri Jan 27 14:19 
Thu Aug 30 16:01 
Thu Aug 30 15:44 
Thu Aug 30 15:44 
Thu Aug 30 15:45 
Thu Aug 30 15:44 
Thu Aug 32 15:44 
Thu Aug 390 15:44 
Thu Aug 30 15:44 
Mon Jul 16 11:25 


1 
i 
2 
2 
1 
i 
1 
1 
Crw-rw-ryu- i Non Jul 16 11:25 
i 
1 
1 
1 
1 
i 
1 
1 
1 
1 


1984 
1984 
1984 
1984 
1934 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 
1984 


Figure 3-8. ls -l of /dev. 


3.4 SYSTEM PROTECTION (IMPORTANT) 


REGULUS' system protection feature is one of its greatest 
assets. Access to files in the REGULUS file system is 


controlled by: 


2 User accounts 
@ File mode (permission bits) 


® File ownership 


3.4.1 User Accounts (ESSENTIAL) 


There are three types of user accounts: 


& Root user (also known as superuser) 


® Special function users 


@ Regular users 
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3.4.1.1 The root User (ESSENTIAL) 


All system functions and capabilities are available to 
the root user. The root user owns the root directory 
and all major directories. The system administrator, 
when logged on as the root user, can go anywhere and 
do anything in the file system, regardless of 
restrictions placed on other users. 


In addition, certain system programs and maintenance 
functions can only be performed by the root user. The 
root user creates regular uSer accounts and controls 
regular user access to the file system. (See Section 
7 for details.) 


The system administrator must operate as the root user 
to perform certain duties. For system security, the 
root user should have a password that is known only to 
a few trusted individuals. When you initialize 
REGULUS (i.e., install it for the first time), the 
root user has the password "secret". We recommend you 
Change root's password. 


Because the root user operates without restrictions, 
it is easy for the root user to cause problems. 
Therefore, only operate as root to perform system 
administrator duties. 


3.4.1.2 Special Function User Accounts (ESSENTIAL) 


There are three special function user accounts that 
came with REGULUS: 


@® maint 


@ install 
@ shutdown 


Like the root user, special function user accounts 
should be used only by the system administrator and 
should have passwords known by only a few trusted 
individuals. When you initialize REGULUS (i.e., 
install it for the first time), maint, install, and 
shutdown have the password "secret", We recommend you 
Change each and make it different from the others and 
from root's password. 
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The maint User Account 


The system administrator should only operate as 
the maint user when the file system is undergoing 
Maintenance or repair. 


The most common use of maint occurs when a file 
System check has shown file system inconsistencies 
that are not easily repaired. If this occurs 
during start up or shut down, see 5.5. 


The install User Account 


The system administrator operates as the install 
user when loading software. See 7.3 for details. 


The shutdown User Account 


The system administrator operates as the shutdown 
user whenever (usually at the end of each day) the 
system should be safely brought down. See 5.4 for 
details. 


3.4.1.3 Regular User Accounts (ESSENTIAL) 
By convention, each regular user has a home directory 


which is the present working directory at log on. 


Usually, each REGULUS user owns all the files in his 
directory and controls access (read, write, and 
execute) to all his files. Each user may control: 


@ Access to his own files 
® Access to his files by his group 


@ Access to his files by other users NOT in 
his group (Groups are described in 7.6.) 
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3.4.2 Protection Features in the File /etc/passwd 
(ESSENTIAL) 


The file /etc/passwd contains information about user 
accounts. It is created at system initialization and 
Maintained by the system administrator Operating as the 
root user. Certain users are included in the passwd file 
when it is generated. These include the root user, maint 
user, install user, and shutdown user. 


The /etc/passwd file contains the following information 
for each user account: 


1. User name 

2. User password 
3. User ID (UID) 
4. Group ID (GID) 
9. Home directory 


6. Program to use as the shell (1.e., to execute 
at log on) 


Figure 3-9 is an example of an /etc/passwd file. 


root: #vWQ1114:O:g3/s3 

Maint::O@:@:/: 
inetall::@:@:/usr/install: 

shutdown: :0:6:/etc: 
gerry:?1:@:/usr/gerry: 
Marna:?:2:0:/usr/marna: 

obie? #vyAl1?71Q:3:1:/usr/obie: 

mes: Vv@olpld:4:1:/usr/mss: 
final_notes::5:@:vusr/tfinal_notes: t 
final_man::5:@:/usr/final_man: 


Figure 3-9. Example of an /etc/passwd File. 
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USER NAMES are the names typed at the "login" 
prompt. 


USER PASSWORDS are an optional feature which 

restricts access to a user's files, 
NOTE 

When REGULUS is generated, the root user account 


is created with a password of "secret". We 
recommend you change the root password and limit 


knowledge of the new password to a few trustworthy 
individuals. Many system administrator duties 
must be performed by operating as the root user. 
We recommend that only the system administrator 
Operate as root. 


USER IDS (UID) are identifying numbers. Each user 
has a UID. A UID is unique to each regular user. 
The root, install, maint, and shutdown users have 
the same UID of @ because they all have the same 
"superuser" ability, although each performs 
different “superuser" tasks. , 


GROUP IDS (GID) is an optional feature which lets 
you limit access of the groups files to members of 
the group. (See 7.6 for details on setting up 
groups. ) 


HOME DIRECTORIES are the present working 


directories when users log on the system. A home 
directory may contain any number of subdirectories 
and files. Each home directory is at the top of 


its own miniature tree-structured file system. 


PROGRAM TO USE AS THE SHELL is the full path name 
of the program that translates and executes the 
commands you enter. The default shell /bin/sh is 
used if no other shell is specified. 


See Appendix E for a detailed discussion of the 
/etc/passwd file. 
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3.4.3 File Mode (IMPORTANT) 
Each REGULUS file has three levels of protection: 

® Owner usage rights 

® Group usage rights 

® All others usage rights 
Each file has ten permission bits called the file MODE. 
These specify the usage rights for that file. Read (r), 
write (w), and execute (x) permissions are specified for 
the three levels of protection. 


See 7.9 for instructions on changing modes. 


Also see the on-line documentation under chmod (cmnd). 


3.4.4 File Ownership (IMPORTANT) 


When a file is created, its owner is the user name, not 
the owner of the current directory. 


Only the root user can change the ownership of a file. 
See 7.10 for instructions. 


Also see the on-line documentation under chown (cmnd) . 


To display the owner of a file or directory, use the ls -1 
command. 


3.4.4.1 The root User (ESSENTIAL) 


The root user owns system files and privileged files. 
Many REGULUS commands and functions can only be 
performed by the root user. This provides security for 
Vital and sensitive files. 


The root user may go anywhere in the file system 


regardless of the permission restrictions regular 
users have placed on their files. 
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NOTE 


Because root has unrestricted access to all the files 


in the file system, the potential to cause serious or 
irreparable damage when operating as the root user is 
great. Therefore, ONLY OPERATE AS ROOT WHEN YOU 
CANNOT PERFORM YOUR TASK AS A REGULAR USER. 


3.5 REGULUS MEMORY (RECOMMENDED) 

Logically, REGULUS memory is divided into three areas: 
@® Operating system memory 
@® "Wasted" space 
@ Executable task memory 

When you start up the system, it displays a banner with 


REGULUS information, as in Figure 3-18. The last line gives 
the amount of memory for each of the areas mentioned above. 


REGULUS x.x date #x 

Copyright Alcyon Corp. 

@(#) Version * x.x.x date/time for CIES 680 System 
sys/non/ust xXK/xXKXKXK/ XX 


Figure 3-18. REGULUS Banner. 


Figure 3-11 illustrates the logical representation of memory. 
Refer to this figure as you read the following text. 
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REGULUS  _—ist 


FSGS pec 
| ss SYSTEM BUFFERS 7 
a ~ REGULUS © 7) 
TABLES 


“WASTED” < “WASTED” SPACE 


TASK 1 


- — — — — BUFFER—- — — —- 


| TASK 2 HARD DISK 
|___ _____ BUFFER. ____ > : = 


EXECUTABLE 3 ; 
FREE SPACE 


TASK 3 


SWAP SPACE 


— — — — BUFFER - — — — 


- FREE SPACE | 


Figure 3~11. REGULUS Memory. 
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3.5.1 Operating System Memory (OPTIONAL) 


The operating system memory area is where REGULUS resides. 
It is located at the very beginning of the memory area. 


When REGULUS is loaded into memory, via an IPL (Initial 
Program Load) from the hard disk, the REGULUS program is 
placed as the very first item in memory. 


The system data buffers are located after the REGULUS 
program. These hold data that will be written to the hard 
disk every 3@ seconds by the /etc/update program. 


Next, the system tables area contains information about 
REGULUS and about your system configuration. REGULUS 
needs this information to coordinate system activity. 


3.5.2 "Wasted" Memory Area (OPTIONAL) 


The "wasted" area is unused (or free) memory space which 
no one can access. It acts aS a small boundary between 
the operating system area and the executable task area. 


3.5.3 The Executable Task Memory Area (OPTIONAL) 


User programs reside in the executable task area. Each 
task is allocated its own space. Part of each task's area 
consists of a buffer containing data required by the task. 


3.5.3.1 Swapping (RECOMMENDED) 


When there are more tasks to be executed than fit in 
the available memory, some tasks are temporarily 
halted and are moved to a specially allocated swap 
space on the hard disk. The tasks left 1n memory 
continue processing. 


Transferring a task to the hard disk swap space is 
called swapping the task out. Moving the task back 
into memory to continue processing is called swapping 
the task in. 


When swapping occurs, you may experience slightly 
degraded system performance. You may need to increase 
your memory by adding another memory board to your 
system if this occurs frequently. 
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Swapping is a complex process which REGULUS 
coordinates without user intervention. 


To see which tasks are swapped out: 
Type: ps ~el 
Press <RETURN> 


Swapped out tasks are indicated in the ps -el display 
by <out>. (Unused getty tasks are usually swapped 
Out. ) 


3.5.3.2 Writing Data to the Hard Disk (RECOMMENDED) 


When a data buffer in a task area is full, REGULUS 
automatically writes that information to the system 
buffers located in the REGULUS program part of memory. 
The information remains in the system memory until it 
is written to the hard disk. 


REGULUS has a feature that automatically writes the 
information in the system buffers to the hard disk 
every 38 seconds. This program is called /etc/update. 
The /etc/update program does a sync (synchronize) 
system call. When a sync is performed, the contents 
Of REGULUS memory and the hard disk are synchronized 
(1.e., made up-to-date) . 


3.6 PROCESSES (IMPORTANT) 
A process is a task or program that is being executed. 


Processes are often talked of as living entities. That is, 
processes have a parent, children, are born, am die. 


Each process inherits certain traits from its parent, such as 
the owner, environment, mode, etc. However, each process has 
its own process ID (PID). When a parent process creates a 
child process, the parent process remains intact. 
Each REGULUS process has: 

® A process ID (PID) 

@ A parent process ID (PPID) 


& A user ID (UID) 
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To display current processes: 


Type: ps —el 


Press <RETURN> 


Figure 3-12 shows an example of 


a) 
c 
o 


@ 
l 
9 
10 
il 
57 
12 
13 


@ 


—" 


PID PPID NICE 


17 
128 
126 
128 
128 
128 
126 
128 


PRI 

17 
256 
256 
256 
257 
256 
256 
261 


SIZ 
@ 
14 
5 
19 
28 
12 
8 
28 


a REGULUS process 


ttyl 
tty2 
tty2 
tty3 
tty4 


TIME 
0:30 
0:00 
0:01 
0:00 
@:@01 
0:09 
O20) 
@:@6 


table. 


COMMAND 
sWwapper 


init 


/etc/update 
<out> 


#sh 


<defunct> 
/etc/getty 


#ah 


] 


19 
14 
122 
206 
207 
209 


—" 
en OE el oe SS) 


126 
128 
128 
128 
128 
128 


256 18 
256 8 
289 34 
256 30 
256 38 
256 38 


0:01 
O:@1 
0:13 
O:@1 
0:09 
0:00 


tty4 
tty7 
console 
console 
console 
console 


ps —-el 
fetc/getty 1 
#58h 

MAKE. MANUAL 
find -type 
ps ~el 


122 
206 
122 


@ 
@ 
@ 
@ 
5 
5 
@ 
4 
4 
if) 
@ 
@ 
@ 
@ 


Figure 3-12. A Current Process Table - The ps -el Cammand. 


In figure 3-12, look at PID 122. Its parent process is PID 1; 
its two children are PID 206 and PID 209. Because PID 2807's 
parent 1s PID 206, PID 207 is PID 122's grandchild. 


Once in awhile you may need to terminate (or kill) a process 
listed in the process table. Follow the instructions in 7.1l. 


NOTE 


When a process is Killed, all its children are signalled and 


may also be killed. But, they may not terminate immediately 
if they are still running. 
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3.6.1 Defunct Processes (IMPORTANT) 
Occasionally, the process table indicates a defunct task, 


<defunct>. A defunct task is a child process whose parent 
has not waited for the child to complete. 


To eliminate defuncts, at the terminal that reports the 
defunct (s) : 


Type: wait 
Press <RETURN> 


3.6.2 Foreground and Background Processes (OPTIONAL) 
There are two kinds of processes: 
® Foreground 


@® Background 


When a foreground process is performed, other activity at 
the terminal is suspended until the task completes. When a 
background task is performed, you are allowed to start 
another process even though the background task is not 
completed. 


For the most part, the only background processes you will 
run are: 


e@ The /etc/update program 


@ Printing processes 


The /etc/update program writes data to the hard disk every 
38 seconds. The /etc/rc file starts /etc/update every 
time you bring the system up. 


Most of your printing tasks are automatically run as 
background processes. 
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3.6.3 Single-User Mode vs Multi-User Mode (ESSENTIAL) 
REGULUS can operate in either of two modes: 
® Single~-user 


® Multi-user 


3.6.3.1 Single-User Mode (ESSENTIAL) 


In single-user mode, only the console is available for 
use, limiting the system to one user. Single-user 
mode 1S appropriate for performing system maintenance 
and repair work which cannot be done without 
interfering with, or interference from, other users. 
Because of this, the maint user operates in this mode. 
We recommend that only the system administrator 
operate in single-user mode. Some REGULUS maintenance 
functions such as fsck -s (file system check and 
realignment) can ONLY be done in single-user mode. 


To get to single-user mode, log on as the shutdown 
user. See 5.4 for instructions. 


NOTE 


In single-user mode, information is NOT automatically 
written to the hard disk. If you are in single-user 


mode and wish to write to the hard disk after you have 
completed a task, use the sync command: 


Type: sync 
Press <RETURN> 


3.6.3.2 Multi-User Mode (ESSENTIAL) 


Multi-user mode opens communication with all the 

terminals on your system so that many users can use 

the system simultaneously. In multi-user mode, 

REGULUS runs the program /etc/update as a background 

process. The /etc/update program writes data that has 

changed to the hard disk every 38 seconds. This 

feature protects you from losing valuable data and 

information since the hard disk is automatically 

updated. ama 
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3.6.4 Initial Program Load (IPL) (ESSENTIAL) 


The Initial Program Load (IPL)is an important process that 
the system administrator must perform periodically. It 
loads a program from diskette or hard disk into system 
memory. Usually, an IPL loads REGULUS. Sometimes this 
procedure is called “booting" or "resetting". 


NOTE 


IPLing interrupts all tasks. If users are still logged 
on the system, if files are open, or tasks are still in 


progress when an IPL is performed, your file system may 
become unreliable and you may lose valuable data. ONLY 
PERFORM AN IPL WHEN ALL OTHER USERS ARE OFF THE SYSTEM 
AND ALL OTHER TASKS ARE COMPLETED. 


In most cases, you will perform an IPL by logging on as 
the shutdown user. (See 5.4 for instructions.) 


Detailed information about IPLing is included with the 
instructions for performing an IPL are given in 7.4. 


3.6.5 Processes: A Typical Start Up (RECOMMENDED) 


To umderstand processes and how they flow from one to 
another, it is helpful to track the series of processes 


that bring the system from a shut down state to a 
multi-user state. 


Figure 3-13 illustrates these processes. 
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12 


Processes: A Typical Start Up 


PROCESS 


The system is shutdown. 


PressiPL.ssts~sSSS 
Please specify boot device 


| Press <RETURN> 


PROM performs memory tests. 
if Memory sizeXXXK 
0-OK 1-O0K 2-O0K 3-OK 


PROM reads !n boot block 


Boot block reads in /regulus. 


Boot biock starts /reguius. 
REGULUS copyright Aiycon ) 


REGULUS initializes devices. 


Sys/Non/Wst 


Din/sh executes commands in 
etc/rc. 


fetc/init starts/etc/getty for 
each terminal. 


2a erga, erro - ~ aera 


Type. User name 
Press: <RETURN> 
Type: Password 
Press: <RETURN> 


fetc/getty starts 
ibin/login. 


ibinjiogin passes control to 


the users shneil. 
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Block Print: System Task 
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( System Message } 


fetcirc file error. 


if Filasystem in need 
of repair 


Log on as ‘maint”™ 
to repai the file system. 


11 


Log on tailed. /bin/login 
allows 4 log on attempts. 
then passes control back to 
fetc/getty. 


3=32 


COMMENTS 


Power is ON to CPU and peripnerals. 


| System runs PROM IPL program on nard ware | 


If you dont see the message. the tests nave 
fatied. 


System boots from nard disk. The boot block | 
iS the first block on the hard disk. IPL PROM 
reads it into memory and transfers execution | 
to if. 


| Boot biock finds /REGULUS ana reads it into 
memory and transfers execution to it 


REGULUS determines the number of 
terminals. printers. etc. configured. 


This is the first process in the task table -PID | 
0. 


This ts the second process in the task table 
-PID 1. 


The REGULUS shel! starts to read /etc/rc. 


The shell executes the commands in /etc/rc 
including fsck. If the commands execute. the 
system comes up in multi-user mode. If any 
command fails the system stays in singie- 
user mode so you can fix the problem. 


/etc/init determines which terminals to open } 


f/etc/getty opens communication with 
terminalis. 


A user logs on the system. 


IDiniogin Compares user name and 
password. If they match /etc/password. user 
can use REGULUS. If they don't. control 
reverts back to /etc/getty. 
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3.7 REGULUS ENVIRONMENTS (IMPORTANT ) 


An environment is the set of conditions under which you 
Operate in REGULUS. A user's environment must reflect several 
conditions including: 


@ His terminal type 
® What application software he is using 
@ His home directory 


YOU control your environment. It does not change 
automatically with a new terminal, home directory, etc. 


When you log on, your default environment is automatically 
created by the /bin/login program. After you are on the 
System, parent processes pass their environment to child 
processes. 


REGULUS uses a default set of environment variables to create 
each user's environment. You may change these at any time. 
(See Appendix F for details.) 


To display your environment (i.e., your current set of 
environment variables): 


Type: setenv 
Press <RETURN> 


You will see something like the example in Figure 3-14, 


PATH=:/bin:/usr/bin 
HOME=/usr/gerry 
LOGNAME=gerry 
USER=gerry 
SHELL=/bin/sh 
CWD=/usr/gerry 


Figure 3-14. setenv Display. 


Environments for regular users are usually set up in the 
-nshrc file (see 3.9.3.3). See the on-line documentation 
under environment (misc). 
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3.8 THE REGULUS SHELL (IMPORTANT) 


The shell is one of the most powerful REGULUS features. It 
has two aspects, 


@ A command interpreter 

@® A shell script interpreter 

As COMMAND INTERPRETER the shell prompts you for a 
REGULUS command and then analyzes and executes the 
appropriate task. 

As SHELL SCRIPT INTERPRETER the shell lets you set up 


shell scripts to perform a task or series of tasks 
automatically. 


NOTE 


A discussion of the shell as shell script interpreter 
is beyond the scope of this manual. See the on-line 
documentation under sh (camnd) for this information. 


3.8.1 The Shell as Command Interpreter (RECOMMENDED) 


The shell is the feature that reads and translates the 


commands you enter into instructions which the REGULUS 
kernel and REGULUS utilities execute. 


A REGULUS command 1s a sequence of one command name 
followed optionally by command arguments. The simplest 
type of command is one word with no arguments. For | 
example, the ps (process status) command lists the 
processes YOU are currently running. To execute ps: 


Type: ps 
Press <RETURN> 


Most REGULUS commands have optional arguments that may be 
included on the command line. A command's arguments 
modify operation of the command. 
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To specify optional arguments: 
1, Leave one blank space after the command name, 
2. Enter a dash (-). 
3. Enter the argument (s) immediately after the 
dash. 
To use the ps example, the arguments e and 1 modify ps to 
list all currently running processes: 
Type: ps -el 
Press <RETURN> 
Appendix G describes other important features of the 
shell. 
3.9. SYSTEM ADMINISTRATOR FILES (ESSENTIAL) 
There are important REGULUS files the system administrator 
Should be aware of. Most of these files reside in the fete 


directory. These files include: 
@® System files generated by the system 
@ System files created by the system administrator 


e User files 


3.9.1 System Files Generated by the System (ESSENTIAL) 
System files are files that REGULUS uses to manage and 


maintain the system. Most of these are shipped with 
REGULUS from the factory. 
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3.9.1.1 Modifiable System Files (ESSENTIAL) 


There are four necessary system files that the system 
administrator can modify using the REGULUS ed program: 


@ /etc/passwd 
e /etc/rc 
e® /etc/ttys 


e /etc/disks 


The /etc/passwd File 


The /etc/passwd or passwd file contains log on 
information for all users. The program /bin/login 
reads this file when a user logs on. 


When the system is generated, /etc/passwd 
automatically includes the root user, the maint 
user, the install user, and the shutdown user. 


For more information on the passwd file, see 
Appendix E or the on-line documentation under 
passwd (cmnd). 


The /etc/rc File 


The /etc/re or rc (run command) file contains a 
series of commands that are executed when the 


system first starts up. When delivered, the rc 
file includes commands to: 


@ Check the file system using the fsck 
command and perform simple file system 
repairs 


@ Display cautionary information 


@ Prepare the system for possible 
mounted file systems 


® Run the /etc/update program in 
background mode 


The system administrator operating as the root 


user May add, modify, or delete commands from the 
re file, | 
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The /etc/ttys File 


The /etc/ttys file contains information about the 
configured terminals. Each line contains 
information for one terminal. For details see the 
on-line documentation under ttys (files), config 
(maint), and setport (maint) . 


The /etc/disks File 

The /etc/disks file contains information about the 
various hard disks available with CIES systems. 
This information is used by REGULUS in some of its 
Calculations. If you add another hard disk to the 
system, you can modify /etc/disks to include it. 


For more information see the on-line documentation 
under disks (files). 


3.9.1.2 Unmodifiable System Files (RECOMMENDED) 


ae The system administrator CANNOT modify the following 
, system files: : 


e /etc/dtab 
e /etc/utmp 
@ /etc/mtab 


e® /etc/spstty 


The /etc/dtab File 
The /etc/dtab file is used by the dump command to 
record the name and the last date for each file 


system dumped. For more information see the 
on-line documentation under dtab (files). 


aot 
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The /etc/utmp File 

The /etc/utmp file is a temporary file created 
when the system comes up in multi-user mode. It 
contains one short entry for each user currently 
logged on the system. See the on-line 
documentation under utmp (files) for more 
information. 

The /etc/mtab File 

The /etc/mtab file is created and removed by the 
mount and unmount commands. It contains 
information about file systems that are currently 
mounted. Users cannot change mtab. See the 
on-line documentation under mtab (files) for more 
information. 

The /etc/spstty File 

The /etc/spstty is created, modified, and removed —_- 


by the /etc/lpconfig program. It is a list of the 
Stty (set terminal characteristics) commands for 
serial printers, which must be performed every 
time the system starts up, if you have serial 
printers on your system. The commands execute 
through the /etc/rce file. For more information 
See the on-line documentation under lpconfig 
(maint) . 


3.9.2 System Files Created by the System Administrator 
(RECOMMENDED ) 


The system files that can be created by the system 
administrator (using the REGULUS editor, /etc/ed) to 
perform an optional function are: 

e /etc/sitename 

e /etc/mnotd 

e /etc/group 


e /etc/fmountfiles 
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3.9.2.1 The /etc/sitename File (RECOMMENDED) 


The /etc/sitename file is designed to contain 
identifying information about the particular system or 
System site. The contents of the file are displayed 
BEFORE the REGULUS login prompt. The file length is 
limited to one block (512 bytes). 


For example, if the contents of sitename are: 


CIE Systems 688/30-46 Documentation System Room 
3476-F 


The screen would display the following whenever a 
terminal is at the login prompt: 


CIE Systems 6880/30-46 Documentation System Room 
3476-F 
Login: 


3.9.2.2 The /etc/fmotd File (RECOMMENDED) 


/etc/motd (message of the day) contains text that is 
displayed directly AFTER a user has logged on. There 


is no length limit on motd, but practically, if the 
message 1S more than one screen, it will scroll out of 
view before it can be read. This file is useful for 
Sending information about the system to all users. 


3.9.2.3 The /etc/group File (RECOMMENDED) 


The /etc/group file is set-up similarly to the 
/etc/passwd file. Each group has one line of 
information in the group file. See Section 8 for 
information on creating user groups. 
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3.9.2.4 The /etcf/mountfiles File ( 


RECOMMENDED) 


The /etc/mountfiles file contains the names of 
mountable file systems and the directories, they are 
mounted under. 


You can set-up your system to mount the listed files 
automatically. See 7.14 for this information. 


For more information on mountfiles see the 
on-line documentation under mountfiles (files). 


3.9.3 User Files (RECOMMENDED) 


Besides the system files described above, there are 
several helpful user files users may wish to create. They 
are: 


& -login (valid only in a home directory) 
@ .logout (valid only in a home directory) 
@® .nshrc (valid only in a home directory) 
@® .dirname | 


Any user may create these files. The dot (.) in the name 
indicates that to certain commands these files are 
"hidden" or “invisible.” That is, they are not displayed 
when the directory contents are displayed using the dir 
command. 


3.9.3.1 The .login File (ESSENTIAL) 


A .login (pronounced dot login) file can be placed in 
each user's home directory. The .login can contain 
instructions, commands, aliases, and environment 
variables. This file 1s executed when the user logs 
on the system. The aliases and environment in .login 
operate the entire time the user is logged on and 
using his login shell. 
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Figure 3-15 shows an example of a .login file. 


alias a "alias" 

set prompt "yes gerry? [—\!]J " 

ah "history " 

ao “logout" 

ap "ps -el" 

all "ls -1" 

ae "/bin/ed ~-t23" 

echo "AVAILABLE ALIASES: a» h» of p» ll, e" 


Figure 3-15. Example of a .login File. 


3.9.3.2 The .logout File (OPTIONAL) 


The .logout (pronounced dot logout) functions much 
like .login. It executes whatever logout tasks you 
wish to perform when you log off the system. You may, 
for example, wish to remove any temporary files, etc. 


Figure 3-16 shows an example of a useful .logout 


rm /usr/gerry/temp/ * 
echo "THANKS FOR USING YOUR CIES 680 SYSTEM" 


Figure 3 -16 Example of a .logout File. 


3.9.3.3 The .nshre File (ESSENTIAL) 


The .nshrc (new shell run command) file executes any 
time a new shell program is invoked. Like the .login 
file, it is also in the user's home directory. If a 
user has both a .nshre and .login file, .nshrc 
executes BEFORE .login. 


The difference between .nshrc and .login is that 
-login is invoked only once when the user logs on. 
The .nshrc file may be invoked any number of times - 
whenever a new shell is run. So, .nshrc should 
contain only information pertinent to a new task. 
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The .nshrc file usually contains certain environment 
variable values having to do with terminal settings, 
etc. 


Figure 3-17 shows some examples of .nshre files. 


set prompt “newshell [\!] 
set history = 75 


Figure 3-17. Example of a .nshrc File. 


3.9.3.4 The .dirname File (RECOMMENDED ) 


A user can have one .dirname (pronounced dot dirname) 
file in each of his directories. The .dirname file is 
a text file which is displayed whenever the user runs 
the dir command on a directory which contains a 
dirname file, as a header, 


The .dirname file can contain identifying information 

about the contents, size, owner, of the directory. a 
The contents of .dirname appear after the full 

directory pathname and directly before the contents of 

the directory. 


Figure 3-18 shows examples for .dirname files. 


8 18 the MASTER directory for CIES 
documentation. 


-dirname Do not change anything in this directory. 


The subdirectories LEX, Acct, BSP, MSP. Med, 
and UltraCalc contain the documents for that 


Coy aw ae = we 2 os @&o2 an 


Product. 
dir ' (BSP ] (LEX ) (Acct ] 
H {Ned ] (MSP ] {UltraCalc]) 


Figure 3-18. Example of a .dirname File. 


SES NESE ATER MME: SH ORE SRI SE SPER LIDS LE SHAR I MY a IIS 


TT AE Se EEA RG SEEMED ACETONE ee 
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4.1 INTRODUCTION 


There are several tasks you should perform BEFORE you use your 
new system on a daily basis. These tasks help prevent 
problems from occurring, and help you deal easily and 
effectively with problems that might occur. 


Perform the following preoperational tasks in the order they 
are presented: 


Section 
Number Topic 


4.2 Install your hardware 

4.3 Put pertinent documents in these binders 
4.4 Set up your terminals 

4.5 Run the Exerciser diskette 


4.6 Get a box of diskettes and cartridge tapes 


4./ Install REGULUS software 

4.8 Install all your other software 
4.9 Format your box of diskettes 
4.1¢ Learn to log ON and OFF 


4,11 Make a listing (a paper copy) of the /etc/passwd 
file 


4.12 Make a listing of the root (/) directory 


4.13 Copy vital system diskettes 


4.14 Backup and restore your file system 
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ro 
NOTE 
Instructions for some of the above tasks appear in other CIES 
documents. You will be directed to all pertinent documents. 
4.2 INSTALL YOUR HARDWARE 
Follow the instructions in your CIES 68@ Installation 
Manual(s) to install your hardware properly. 
4.3 PUT THE PERTINENT DOCUMENTS IN THESE BINDERS 
The System Administrator's Manual binders are designed to be 
the repository of most system information. These binders have 
tabs for: 
—_— 
@ Shutdown Status Sheets (see 5.4) 
@ Release Notes 
® Utility Instruction Guide 
6 Exerciser and Diagnostic Instruction Guides 
@® OPENFIRST documents 
& Installation Procedures 
® Operator's Guide 
@ Trouble Shooting Guides 
® Service calls 
® Hardware upgrades 
® Maintenance contracts 
® Miscellaneous 
Put the above documents in place so that when you need 
information, you can find it easily. eo 
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4.4 SETTING UP YOUR TERMINALS 


CIES software expects CIES terminals to use certain set-up 
modes. Your software may not run correctly if your terminals 
are not set-up correctly. 


NOTE 


CIE Systems Operator's Guide tells you HOW TO SET YOUR 


TERMINAL MODES. 


set-up modes. 


Tables 4.1 through 4.6 show the recommended 


In these tables an asterisk (*) indicates that the control 
condition MUST BE SET TO THE INDICATED VALUE. 


There are five CIES terminals: 


CIT-101 


CIT-161 


CIT-8@z 


CIT-508 


4 
f 


> set-up similarly 


4.4.1 CIT-101 and CIT-161 Terminal Set-Up Groups 


The following tables give the correct set-up groups for 
the CIT-191 and the CIT-161l. 


CIE SYSTEMS REGULUS 


4-3 


SYSTEM ADMINISTRATOR'S MANUAL 


Section 4, Preoperational Tasks 


Table 4-], 


SET-UP 
FTELDS 


i 


CIT-191 and CIT-161 Terminal Set-Up Group B 


SET-UP 

CONTROL CONDITION VALUE 
Scroll Style: Jump 
Auto Repeat: On 
screen Background: (191) Dark 
Normal Attribute: (161) Off 
Cursors Block 
Margin Bell: Off 
Keyclicks: Silent 
Node: ANSI 
AUTO XON/XOFF On 
Shift-3 # 
Auto Wrap.: Off 
Newline: Off 
Interlace (only): (1@1) Off 
Reverse Video (161) On 
Parity: Odd 
Parity: Disable 
Bits/Char: — 8 
Screen Freq.: (191) 6OHZ 
Interlace: (161) Off 

3 (8/0): fy 
Flags (4/@): @ 
Flags (2/0): @ 
Flags (1/0): i) 


Screen Display of CIT-1@1 and CIT-161 Group B 


CIT-1@1 


CiIT~-161 


CIE SYSTEMS REGULUS 


1 ©1901 2 0611 3 9900 4 g@1¢9 
5 ©0660 T SPEED 9600 R SPEED 9600 


1 @191 2 6011 3 6000 4 @@11 
5 ©6206 T SPEED 9600 R SPEED 9606 
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Table 4-2. 


SET-UP 
FIELDS 


1 


CIT-~191 and CIT-161 Termi 


CONTROL CONDITION 


Smooth Scroll Speed: 
Scroll Key Style: 
Aux Numeric Key Pad: 
Form~ feed: 


Control Chars: 
Incoming XOFF (_ Bs) 
Cursor: 

Cursor: 


Screen Data on 80-132 
Change: 

RH of DW Lines: 

Erase Page Extent: 

Tab Motion: 


CRT Saver: 

Half/Full Duplex 
RTS/CTS Handshake 
8th Bit on Transmit: 


Stop Bit on Transmit: 


nal Set-Up Group C 


SET-UP 
VALUE 


Normal 
VT1@0@ 
Norma l 
Line feed 


Execute 
Enabled 
Visible 
Blinking 


Preserve 

Preserve 
Within Margin 

Direct 


On 

Full Duplex 
Enabled 
Space 


1 


Screen Display of CIT-181 and CIT-161 Group C 


CIT-101 


Cit=16i1 


CIE SYSTEMS REGULUS 


1 


1 
= 


0200 2 6001 3 #019 4 10060 5 @ 


2006 2 6001 3 6019 4 1009 
@ 


6 160099@ 7 


DGBOOOO1 
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4.4.2 CIT-88z Terminal Set-Up Modes 


Table 43 ) 


CIT-88z Terminal Set-Up Modes 


SET-UP SET-UP 

FIELD CONTROL CONDITION VALUE 

A & B Main Port Speed: 36900 
Aux. Port Speed: 129090 


Main/Aux Parity: Even 
RCVR Parity Check: Off 
Normal Video: Dim 


Respond to XON/XOFF: Yes 


Generate XON/XOFF: Yes 
Duplex: Full 
CRT Saver: On 


Kybd Auto Repeat: On 
Keyclick: Off 


Shift 3:3 # 
Ansi Cursor Key: | 


Cursor: 
Cursors: Static 
Background: Dark 
Display Cntrl Codes: No 


Newline: Off 


* Autowrap: Off 
* Mode: ANS! 
Line Freq: 6OHZ 


screen Display of CIT-8@8z Set-Up Modes 


CIT-66z A 1116 B 16@ C 1101 D 0001 E @1@1 F @0@00 G 11190 
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4.4.3 CIT-508 Terminal Set-Up Modes 


The tables below give the terminal set-up modes for the 
CIT-500. 


Table 4-4. CIT-58@ Terminal Set-Up Mode C 


CIE SYSTEMS REGULUS 


Screen Display of CIT-5@0 Set-Up C 


4-7 


SET-UP SET-UP 
FIELD CONTROL CONDITION VALUE 

A Main Port Speed 9666 
Aux. Port Speed 1200 

B Main/Aux. Parity Even 
RCVR Parity Check Off 
Respond to XON/XOFF Yes 
Generate XON/XOFF Yes 

C Duplex Full 
DTR Handshake Off 
CRT Saver On 
Status Line Off 

D Keybd Auto Repeat On 
Keyclick Off 
Shift 3 # 
ANSI Cursor Key Off 

E Cursor Block 
Cursor Blink 
Background Normal 
Normal Video Bold 

F Newline Off 
Autowrap Off 
Mode ANSI | 
screen Length 6564 lines 

G Deply Cntrl Codes N@ 
BS/DEL key Bsa/Del 
Page Width 089 

H Wrap Mode vt10@ 
Terminal Identity vt10@ 


MAIN PORT SPEED:960@ AUX PORT SPEED: 9600 
A 1408 B 3000 C 0016 D 
G 0160 H 12. 


1901 E @@@@ F 1111 
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Table 4-5 e 


SET-UP 
FIELD 


A 


CIE SYSTEMS REGULUS 


CONTROL CONDITION 


Printer Mode 
Printer Type 


Auto Initialize 
Margin Transmit 
Proportional Space 
Auto Video Transmit 
Form Length 
Vertical Increment 


Horiz. Increment 


Print Extent 
Print Formfeed 


CIT-568 Terminal Set-Up Mode D 


SET-UP 
VALUE 


Normal 
F1@ 


Off 

Off 

Off 

Off 

@66 
@12/48 
030/120 


Full Page 1 
Yes 


Screen Display of CIT-5@8 Set-Up D 


A 001 B 0000 C O66 D @12 E 630 F 11 


4—§8 
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Table 4-6. CIT-50@ Terminal Set-Up Mode E 


SET-UP 


FIELD 


A 


Edit Mode 
Edit Key 
Field Transmit 


Space Compression 


Transmit Mode 
Page Size 


Transmit Execution 


Bold Protect 


CONTROL CONDITION 


SET-UP 
VALUE 


Off 
Immediate 
All 

No 


Page 

Full 
Immediate 
No 


Underline Protect No 
Blink Protect No 
Reverse Protect No 
Normal Protect No 


Xmit Line Term Yes 
Eol Terminator Crecr/lf 
Xmit Eot Term Yes 
Eot Terminator EOT 


Xmit Margin Areas Yes 
Page Dump Off 


Screen Display of CIT-5@8 Set-Up E 


A @119 B 9118 C 9000 D 1012 E i@ 
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4.5 RUN THE EXERCISER DISKETTE 
The Stand-Alone Exerciser Diskette contains noninteractive 


diagnostic programs that test your hardware to make sure it 
functions correctly. 


To avoid potential problems, run the Exerciser BEFORE you 
install your software. 


Step-by-step instructions for the Exerciser are given in the 
Stand-Alone Exerciser Instruction Guide. 


4.6 DISKETTES AND OPTIONAL CARTRIDGE TAPES 


To be properly prepared to operate your CIES 688 system you 
should have: 


® Diskettes - see 4,9 for formatting information 


@ Cartridge tapes (only if you have a streamer tape 
drive) 


Diskettes and tapes are permanent Storage devices. You can 
write information to them to: 


@® Serve as a backup for information on your hard 
disk 


® Transfer information from one system to another 


How many diskettes and/or cartridge tapes you need depends on 


your backup method and what type of hard disk your system has. 
To determine the number you need, see 5.4.1.1 for diskettes 
and 5.4.1.2 for cartridge tapes. 


Both diskettes and cartridge tapes are available from your 
dealer. 
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4.7 INSTALL YOUR REGULUS SOFTWARE 


Now you are ready to install REGULUS. Installing REGULUS for 
the first time is called system initialization. 


Part of the REGULUS installation procedure requires that you 
input information from the Media Defect List in the OPENFIRST 
envelope. Make sure you have the list before you start 
initializing. 


The REGULUS diskettes come with an installation instruction 
card. Follow the instructions on the card. Or, follow the 
instructions in 7.2 for installing REGULUS. 


4.8 INSTALL ADDITIONAL SOFTWARE 


After installing the REGULUS Kernel set, install ALL other 
software using the install user account. 


Follow the instructions on the APPLICATION SOFTWARE 
INSTALLATION card that came with your software. Or, follow 
the instructions in 7.3 for installing additional software. 


4.9 FORMATTING DISKETTES 


Formatting prepares diskettes to receive data. Since 
diskettes are shipped from the factory unformatted, you must 
format your diskettes before you use them. 


Formatting an entire box of diskettes when purchased prepares 
you to backup files or make diskette copies at any time. 


Format your diskettes using the Stand-Alone Utility Diskette. 


Follow the instructions in the Stand-Alone Utility Instruction 
Guide for option @, the floppy disk formatter. 


4.16 LOGGING ON AND LOGGING OFF 


To use REGULUS, you must open communication with the system 
uSing an easy procedure called LOGGING ON. 


When finished with a terminal session, use the simple 
procedure called LOGGING OFF. 
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4.19.1 Logging ON 
To log on, you must have a user account with: 

@ User name 

® User password 
Valid user accounts are stored in the /etc/passwd file, 
YOU CANNOT LOG ON THE SYSTEM IF YOUR USER NAME AND 
PASSWORD ARE NOT IN THE /etc/passwd FILE. 
REGULUS comes with four user accounts: root, install, 
maint, and shutdown. Each of these accounts comes with 
the password "secret". (We recommend you change this 


password; instructions for changing passwords are in 7.7.) 


Instructions for adding other user accounts to the system 
are also in 7.5. 


1. At the "Login:" prompt, type your user name, 
For example, if you are logging on as the root user: 


Type: root 
Press <RETURN> 


2. At the "password:" prompt, type the password for your 
login account. 


For example, the root password comes as "secret". To 
enter that password: | 


Type: secret (does not display) 
Press <RETURN> 


3. If your user name and password are correct, a system 
prompt appears. 


At the system prompt, you can begin using REGULUS by 
entering a REGULUS command. 


4. I£ the user name and password you entered are NOT 
correct, the message “login incorrect" appears. 


Try logging on again. 
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4.18.2 Logging OFF 


CP ED ee Oh cae CENCE FD CHD OER SED GUD atte ae CD aR SP TAY ER SG LED CAD SNS ED SED CHD CLEP CE ED GED AD GAD GE OND GEES GAAS GARD COD GED OSSD GUND OSS WEED Od GED SUE Gilt 2b Cet ae ar Te Ce OES ee ES SUS GOED ae 
RD CAREES CEES TED CES MES CSTD MEER GARD TNS ED EMG CLEP MY SEND CUED EMS ATS GED GS WD CAD GD STUD GAD GD CEES GED 9D GD GED OSE CU be cots oe ee ee ce oe SES TUE GE GS OI OD ase: CED GD GERD ERD eRe CS Os ONS Gam ae Ee 


1. At the system prompt (either "#" or "$"): 


Type: logout 
Press <RETURN> 


2. When the "Login:" prompt appears, you are off the 


system. 


4.11 COPYING YOUR /etc/passwd FILE 
The /etc/passwd file contains all the information for user 
accounts, (For details about /etc/passwd, see Section 3 and 
Appendix E.) If this file is damaged or destroyed, you may not 
be able to log on your system. So, we recommend you make and 
keep up-to-date: | 

@ An on-line copy of /etc/passwd 


@ A listing (i.e., a paper copy) of /etc/passwd 


4.11.1 Making an On-Line Copy of the /etc/passwd File 
By making an on-line copy of a file you can rename your 


duplicate and use it if your /etc/passwd file becomes 
unusable. 


NOTE 
In the following instructions, the duplicate file is 


called /etc/passwd.bak You may call your duplicate any 
Name you wish. 
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1. Log on the system as the root user, uSing the root 
password. 


2. At the system prompt: 
Type: cp /etc/passwd /etc/passwd.bak 
Press <RETURN> 


3. The task is completed when the system prompt returns. 
You may enter another command or log off. 


4.11.2 Making a Listing of the /etc/passwd File 


NOTE 


Make Sure your printer is set-up and operating correctly. 


1. Log on as the root user, uSing the root password. 
2. At the system prompt: 

Type: list -p /etc/passwd 

Press <RETURN> 


3. When the system prompt returns, you can enter another 
REGULUS command or log off. 


4. Remove the paper copy from the printer and put it in 
the second binder under the Miscellaneous tab. 
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4.12 MAKE A LISTING OF THE CONTENTS OF THE root DIRECTORY 


We recommend you make listings of the contents of the root (/) 
directory and its subdirectories. If you ever need to delete 
or move files, these listings will show you what files and 
directories should not be moved. 


NOTE 
You should make nine listings - one for each of the following 
directories. In the following instructions, the root (/) 
directory is used as an example. Repeat the instructions, 
substituting the remaining directories listed below: 
e / @ /lib 
e /bin e /mnt 


e /dev /tmp 


/doc /man | /usr 


/etc 


1. Log on the system. 

2. At the system prompt: 
Type: dir / | lpr 
Press <RETURN> 


3. When the system prompt returns, print the remaining 
directories. For example: 


Type: dir /lib | lpr 
Press <RETURN> 


4. When you are finished and the system prompt appears, you 
may enter another command or log off. 
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4.13 COPYING VITAL SOFTWARE DISKETTES 


several of the CIE Systems diskettes you received contain 
vital software. To protect yourself from loss or damage, we 
recommend you make diskette copies of the following and keep 
them in a safe place: 


@ Diskette A - the Self Boot Diskette 
(We recommend YOU make a copy of this diskette 
even though you received a master and copy.) 
@® The Stand-Alone Exerciser Diskette 
® The Stand-Alone Utility Diskette 
@ The Stand-Alone Diagnostic Diskette 
Make diskette copies using the Stand-Alone Utility Diskette. 


Follow the instructions in the Stand-Alone Utility Instruction 
Guide for option 3, the one-drive floppy copy. 


4.14 BACKUP AND RESTORE YOUR FILE SYSTEM 


4.14.1 Backing Up Your File System 


We recommend you make a cartridge tape or diskette backup 
of your new file system. If your system develops 
problems, you will have a backup that you can reload. 


We recommend you backup every day to protect your valuable 
data. Backups are necessary to replace or rebuild systems 
lost to fire or water damage, theft, or power failure. 


We also recommend that you make a backup as soon as you 
load your system. Keep this backup off Site, secure ina 
fire- and water-proof area. 


Logging on as the shutdown user is the best way to make a 
backup. It safely brings the system down and checks the 
file system for you. 


Follow the instructions for shutting down and backing up 
in 5.4. 
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4.14.2 Restoring Your File System 

We also recommend you restore the set of tapes or 
diskettes you backed up in 4.14.1 to verify that your 
backups are reliable and are protecting your data. 


Follow the instructions for restoring in 5.4, 
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Section 5 
DAILY 
SYSTEM ADMINISTRATOR DUTIES 


5.1 INTRODUCTION 
It is the responsibility of the system administrator to 
maintain the system in good working order. If you 
conscientiously perform the daily system administrator duties 
set out in this section, you can: 

® Prevent most system problems 


@e Greatly speed up the diagnosis and resolution of 
problems that may occur 


This section discusses all the recommended daily system 
duties. They are: 


Section 
Number Topic 


5.2 Keeping the system log 
Ds.3 Starting up the system 


5.4 Shutting down and backing up the system 


5.5 Repairing file system problems 
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902 KEEPING THE SYSTEM LOG 


Every time you shut your system down using the shutdown user 
procedure as detailed in 5.4, a log labeled the Shutdown 
Status Sheet prints out. One of the easiest, yet one of the 
most important, responsibilities of the system administrator 
is to place these logs in this binder in the section provided. 


Keeping these logs provides you with an invaluable source of 


information about your system. Review them monthly as 
recommended in Section 6. 


If you do not get a Shutdown Status Sheet every day, perform 


a file system check (fsck) in single-user mode, and record the 
results. 


5.3 STARTING THE SYSTEM UP 


We recommend you shut your system down once a day, which means 
that you must start it up once a day, too. 


Figure 3-13 in Section 3 is a flow chart of a typical start up 
process. It details specific processes in the start up 
procedure. The discussion in this section focuses on how to 
Start up your system, : 
To summarize the start up process: 

1. Initial Program Load (IPL) executes 

2. The REGULUS software loads into memory 


3. The REGULUS shell executes the commands listed in 
the fetc/rce file 


4. The system comes up in multi-user mode 
The start up procedure is one of the easiest tasks you perform 
aS system administrator. The only input required is pressing 


<RETURN> at the beginning of the procedure and entering the 
date and time at the end if needed. 
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Most of the start up commands are in the /etc/rc (run command) 
file that is executed by the shell (/bin/sh). The most 
important commands in the rc file check the file system and 
perform simple file system repairs. The /etc/rc is described 
in more detail in 3.9.1.1. 


NOTE 


If the file system check started by the /etc/rc file cannot | 
execute properly, your system will NOT start up. This message | 
appears: ! 


File system in need of repair. You must login as maint 
and call your technical representative for assistance. 


IF YOUR FILE SYSTEM NEEDS REPAIR, SEE 5.5. 


NOTE 


The start up procedure usually takes less than 18 minutes. 


NOTE 


To begin the start up procedure, your system console must 
display: 


Please specify boot device 


To get the prompt bring your system down (using the shutdown 
user procedure detailed in 5.3) or press the IPL button (as 
detailed in 7.4). 


If your system is not powered eee follow the instructions in 
7.4.2, IPL Errors. 
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™ 
To start up your systen: 
STEP TASK OR COMMENT 
1. At the prompt "Please specify boot device", 
Press <RETURN> 
This initiates the IPL process shown in Figure 3-13. 
2. The system performs memory tests and loads REGULUS 
software into memory. 
The REGULUS banner appears when REGULUS is loaded: 
REGULUS x.x date #* 
Copyright Alcyon Corp. 
@(#) Version * x.x.x date/time for CIES 688 System 
sys/non/wst xxk/xxxk/xx 
3. The commands in the /etc/rc file are executed. 
This message displays during the file system check: Po 


/dev/rootfs (mounted on /): 


The file check results display when the command is 
finished. 


NOTE 


If your file system has minor inconsistencies, the file 
System realigns automatically, displaying this message: 


Automatic filesystem realignment in progress. 
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4. The system MAY prompt you to enter the time and then the 
date. Type them in following the examples on the screen. 
Press <RETURN> after you have entered each line. 


9. When the remaining /etc/rc commands complete, your system 
comes up in multi-user mode, displaying the prompt: 


Login: 


6. Users may log on and use the systen. 


5.4 SHUTTING DOWN AND BACKING UP THE SYSTEM 
By shutting the system down we mean: 
@ Terminating ALL tasks 


@ Logging off ALL users and preventing other users 
from logging on 


@ Checking the file system and realigning the file 
system if necessary 


@® Performing an Initial Program Load (IPL) so that 
REGULUS software is reloaded into memory 
(optional) 


REGULUS on CIES 688 systems has a shutdown user account which 
lets you shut your system down SAFELY, with minimum disruption 
to users, tasks, and the file system. The shutdown user 

procedure also lets you perform a system backup if you choose. 


A SYSTEM backup is a cartridge tape or diskette copy of ALL 
USERS' files on the system. We STRONGLY recommend you shut 
your system down properly and backup EVERY DAY to prevent loss 
of valuable data from power surges or failure, fire, theft, or 
system problems. 
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The discussion in 5.4 covers: 
® Backing up properly 
® Shutting down and backing up as the shutdown user 


@ Restoring your backups 


5.4.1 Backing Up Properly 


NOTE 


This section details SYSTEM backup only. We recommend 
users backup their own files on a regular basis as 
discussed in your Operator's Guide. 


NOTE 


We recommend you backup by using the procedure presented 
in this manual. It is a variation of the "save" command, 
allowing both ENTIRE and PARTIAL backups (see the 
discussion under “shutdown Procedure Daily Backup 
Rotation", 


If you wish to use the Stand-Alone Utility backup, follow 


the instructions in the Stand~Alone Utility Instruction 
Guide. 


3e4,1.1 Diskette Capacity 


One diskette holds approximately one-third million 
characters of data. 


NOTE 


If you have a 46 or 84 megabyte hard disk, we 
recommend you backup using cartridge tape. 
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If you use diskettes to backup your system, we 
recommend you have five sets: 


3 For three-day backup rotation 
1 For weekly backup 
1 For preoperational backup (see 4.14) 


A 10 megabyte hard disk uses a maximum of 3@ diskettes 
to backup. 


5.4.1.2 Cartridge Tapes 
If you are using cartridge tapes to backup, you must: 


® Protect your tapes from being written on 
by accident 


@ Make sure you have enough tapes to backup 
your system 


Protecting Data on Cartridge Tapes 


The easiest way to do so is to keep the 
write-protect 'key' on SAFE except when you're 
doing a backup. Look for the small round plastic 
pointer at one corner of the cartridge. Just turn 
the arrow to point to the word SAFE (use a small 
screwdriver, coin edge, or paper clip, etc.) 


Store the cartridge on SAFE. Then, to backup data 
from hard disk onto tape, turn the arrow directly 
opposite, AWAY from SAFE; when finished, turn the 
arrow toward SAFE again. | 


Cartridge Capacity for shutdown Procedure Backups 


A 26 megabyte cartridge contains approximately 
32,888 blocks. The Shutdown Status Sheet reports 
the number of used blocks. To determine the 
number of tapes needed to perform an ENTIRE 


backup, divide the number of used blocks by 32,000 
and round up. 
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5.4.1.3 Rotation of Backup Tapes and Diskettes 


We recommend you keep two sets of backup tapes: 


1. Five consecutive days of backup tapes 
stored ON site, but away from the computer 
area. 


2. Weekly backup tapes stored OFF site. 


shutdown Procedure Daily Backup Rotation 
The shutdown procedure lets you make either: 
® An ENTIRE backup - all the user data 


@ A PARTIAL backup - only the user data 
that has changed since the last backup 
(either entire or a previous partial) 


The shutdown backup procedure records the date and 
time of every ENTIRE and PARTIAL backup. Every 
PARTIAL backup made includes ALL user data changed 
Since the last backup (whether it was an entire or 
partial). 


Table 5-1 indicates a five day backup rotation 
using both entire and partial backups. 
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Day 


Number 


Day 1 


Day 2 


Day 3 


Day 4 


Day 5 


Table 5-1. shutdown Procedure Backup Rotation. 


Backup Existing 
Designation Copies 


Backup copy Copy A 
(Entire) 


Backup copy Copies 
(Partial) 


Backup copy Copies 
(Partial) 


Backup copy Copies 
(Partial) 


Backup copy Copies 
(Partial) E 


5.4.2 The shutdown User Procedure 


This discussion covers: 


General shutdown user information 
Terminating currently running tasks 
Shutdown procedure file checking 


Using the shutdown user procedure 


Restoring from backups 


The shutdown user account 1S a special system 
administrator tool that safely terminates all running 
processes and lets you do one of the following: 
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@ Remain in single-user mode (terminating the 
Shutdown procedure) 


@e Shut your system down and IPL 


@ Perform a backup (described in 5.4.1.2), shut 


your system down, and either IPL or bring it 
up in multi-user mode 
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gor, 
Unless you stop shutting down and remain in single-user 
mode, a Shutdown Status Sheet is automatically printed out 
with file check and backup information. Keep these sheets 
in the section provided at the back on this binder. The 
discussion in 6.2 details the importance of the Shutdown 
Status Sheets. 7 


The shutdown user account has its own password, though its 
user ID (UID) is the same as root's, zero (@). The 
shutdown user is shipped with the password "secret." We 
recommend you change it, and only tell the new password to 
a few trusted individuals. (See 7.7 for details on 
changing passwords.) 


5.4.2.1 Terminating Currently Running Tasks 


AS part of the shutdown procedure, all currently 
running tasks (except the shutdown) must be 
terminated. 


Users besides shutdown who are on the system when the 
shutdown procedure begins are given two sets of 
warnings to log off the system. aan 


The first set of warnings lasts two minutes. Every 30 


Seconds a message is sent to their screens asking them 
to log off. 


If ail regular users do not respond to the first set 
of warnings, you can choose terminate shutdown, log 
users off immediately, or send another two minute 


warning. The second warning is much like the first, 
but if users have not logged off at the end of it, the 
system logs them off. 


NOTE 


Users who are logged off by the system at the end of 


the second set of warnings may LOSE VALUABLE DATA, 
Encourage users to heed the warnings to protect their 
files from corruption. 
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304.2.2 shutdown Procedure File Checking 


Unless you choose to remain in single-user mode, the 
shutdown user procedure automatically performs a file 
check (using the fsck command). This protects the 
integrity of the system and the data (that you may 
choose to back up). 


In addition to the root file system (on your hard 
disk), mounted file systems whose entries are flagged 
in the /etc/mountfiles files by either an "a" or "f" 
are also checked. See 7.14 for more information. 


As a corollary, the system also determines the percent 
of used and free space for all the file systems 
checked (using the df command). 


As with the file check performed when you bring the 
system up, if there are minor inconsistencies in the 
file system, the system corrects them automatically. 


However, 1f more serious problems are detected, the 
shutdown procedure terminates and you are directed to 
log on as the maint user and call for technical 
assistance. IF THIS OCCURS, SEE 5.4. 


5.4.2.3 Using the shutdown User Procedure 
The shutdown procedure prompts you with options lists. 


To select the options you wish to perform enter the 
number of the option. 


NOTE 


If the system displays a message that the printer is 
not available, you are prompted to terminate the 


shutdown user procedure or continue with it. If you 
continue, the Shutdown Status Sheet is not printed 
out. Check that the printer is powered up and that 
the "select" light is ON. 
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1. Log on the system as shutdown, using the shutdown 
password. 


2. The following options list appears on the screen: 


1. Shutdown, Backup, reorder freelists and 
Automatic Startup 

2. Shutdown, Backup, reorder freelists and 
execute IPL 

3. Shutdown, reorder freelists and execute IPL 

4. Enter Single-User Mode 

9. Exit SHUTDOWN immediately. 


Select your option: 


Type your response 
Press <RETURN> 


3. The system displays the list of users who are 
currently logged on the system. 


The message appears: 
Disabling new logins 
New users cannot log on. 


If no other users are on the system, skip to Step 


If other users are logged on, this message 
appears: 


Notifying users of system shutdown. 

For the next 2 minutes: 
A message will be sent every 3@ seconds to 
each user who is logged on. The message 
informs them that the system is shutting 
down. Every 38 seconds, you will be 
informed of the number of users still 
logged on. 
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Users who remain logged on after two minutes are 
displayed on the screen and this option list 
appears: 


1. Give another 2 minute warning, then 
terminate all users. 

2. Terminate all users immediately. 

3. Exit SHUTDOWN immediately. 


Select your option: 


Type your response 
Press <RETURN> 


If you entered "3", shutdown terminates, and a 
login prompt appears. 


If you entered "2", skip to Step 4. 
If you entered "1", this message appears: 


Second 2 minute warning to users beginning. 
Message being sent every 38 seconds warning of 
impending shutdown. Every 3@ seconds, you 
will be informed of the number of users still 
logged on. 


The messages continue until all other users are 
logged off. 


4. This message appears: 
The system is now in single-user mode 


If you selected "4" from the first options list, 


you leave shutdown for single-user mode and the 
login prompt appears. 
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3. 
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If you are going to backup skip to step 6. 


If you selected "3" from the first options list, 
you are shutting down without a backup. After the 
Shutdown Status Sheet prints out, the system 
executes an IPL. This prompt appears: 


Please specify boot device 
At this point, you can do one of the following: 


@ Power the system down as described in 
724.2 

@e Start the system up as described in 6.3 

® Boot from a Stand-Alone diskette 


The system reports the dates of your last entire 
and partial backups. 


Then it displays this options list: 


1. Partial Backup with Save utility using 
diskettes 

2. Partial Backup with Save utility using 
Cartridge tapes 

3. Entire Backup with Save utility using 
diskettes 

4, Entire Backup with Save utility using 
cartridge tapes 

3. DO NOT perform backup but continue 
shutdown 


Select your option: 


Type your response 
Press <RETURN> 


If you entered "5", shutdown terminates and a 
login prompt appears. 


If you select any other option, the Shutdown 


Status Sheet prints out, and you are prompted to 


to insert your tape or diskette and begin your 
backup. 
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Each file name displays on the screen as it is 
backed up. If the backup requires more than one 
diskette or tape, you are prompted to remove the 
first diskette or tape and insert the second. 
These prompts continue until the backup is 
complete. 


7. If you selected "1" from the original options 


list, your system is brought up to multi-user mode 
automatically. 


Users may log on when their login prompts appear. 


8. If you selected "2" from the original options 
list, the system executes an IPL. This prompt 
appears: 


Please specify boot device 
At this point, you can do one of the following: 
@ Power the system down as described in 


724.2 


® Start the system up as described in 6.3 
® Boot from a Stand-Alone diskette 
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5.4.2.4 Restoring From Backups 


How you restore data to the hard disk from backup 
depends on the type of backup: 


@ Entire backup 


® Partial backup 


Restoring ALL the Data From Your Backups 


To restore the most current version of ALL the 
data on your system, you must restore your backup 
tapes or diskettes in the following order: 


1. 


Restore your ENTIRE backup 
Restore your OLDEST PARTIAL backup 


Restore your NEAT-TO-OLDEST PARTIAL 
backup, etc. 


Lastly, restore you MOST CURRENT 
PARTIAL backup 


Restore your backups in this order so that the 
newer, Changed files (on the newer partial 
backups) overwrite the older, unchanged files on 
the entire and older partial backups. 
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i. Log on the system as shutdown, using the 
shutdown password. 


2. Using the shutdown user procedure, bring the 
system to single-user mode. Follow the 
instructions in 5.4.2.3. 


3. In single~user mode, log on as root, using the 
root password. 


4. Insert the first ENTIRE diskette or tape in 
the drive. 
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5. At the system prompt, if you are loading from 
diskettes: 


Type: load 
Press <RETURN> 


If you are loading from cartridge tapes: 


Type: load=ct 
Press <RETURN> 


When prompted press <RETURN> to continue: 
Press <RETURN> 


As each file is loaded, its name displays on 
the screen. 


6. If the system prompts you to remove the tape 
Or diskette and insert the next one, make sure 
you are inserting in the correct order. 


Continue following the prompts loading the 
ENTIRE backup until the system prompt returns. 


7. Repeat Steps 5 and 6 to restore your OLDEST 
PARTIAL backup. 


8. Repeat Step 7, restoring each PARTIAL in the 
correct order, given at the beginning of this 
discussion. | 


9. At the system prompt, log off. 
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To restore all the data from your backups, cont.: 
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STEP TASKS OR COMMENT 
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1@. Log on again as shutdown, using the shutdown 
password. 


11. Using the shutdown procedure, shut your system 
down and bring it up again in multi-user mode, 
option "1", 


The shutdown procedure performs a file system 
check, insuring the integrity of your restore. 


12. When your system comes up again in multi~user 
mode, users can log on and enter commands. 


Restoring Selected Files From Your Backup 


To restore SELECTED FILES from your backups, use 
the look command to determine whether the most 
current version of the file(s) you wish to restore 
is on your entire or one of your partial backups. 


After using the look command to determine which 
set of backups has your most current file(s), 
restore each file separately from the appropriate 
backup. 


NOTE 


Have a pencil and paper handy to note the full 
path name of the file(s) you wish to restore and 
the backup set they are on. Copy down the file 
name EXACTLY AS IT APPEARS ON THE SCREEN. Do NOT 
ignore a ".", if it appears. 


NOTE 


If a file is on more than one set of backups, | 
restore it from the NEWEST backup. | — 
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To restore selected files from your backup: 


STEP TASKS OR COMMENT 


1. Log on the system as root, uSing the root 
password. 


2. Insert the MosT CURRENT PARTIAL tape or 
diskette in the drive. 


3. At the system prompt, if you are loading from 
diskettes: 


Type: look 
Press <RETURN> 


If you are loading from cartridge tapes: 


Type: look-ct 
Press <RETURN> 


When prompted to <RETURN> to continue, 
Press <RETURN> 


4. Each file name displays on the screen as the 
look command finds it. 


As they appear, note the full path names of 
the file(s) you wish to restore. 


To stop the information from scrolling off the 
screen before you can note it: 


Press <NO SCROLL> or Press <HOLD SCREEN> 
Press the same key to continue scrolling. 


5. If the system prompts you to remove the tape 
or diskette and insert the next one, make sure 
you are inserting in the correct order. 


Continue following the prompts "looking" at 
the PARTIAL backup until the system prompt 
returns. 


continued ----> 


CIE SYSTEMS REGULUS 5-19 SYSTEMS ADMINISTRATOR'S MANUAL 


Section 5, Daily System Administrator Duties 


Repeat Steps 3, 4, and 5 for your other 
partial backup sets and your entire backup. 
The order should be NEWEST TO OLDEST. 


Now that you know the full path names of the 
files and which partial or entire backup set 
they are on, you can restore. 
Restore each file separately. 


Enter the full path name of your file. Below 
we use /usr/gerry/letr.1 as the example. 


Insert the appropriate backup diskette or tape 


in the drive. If you are restoring from 
diskettes: 


Type: load /usr/gerry/letr.1 
Press <RETURN> 
If you are restoring from cartridge tapes: 
Type: load=-ct /usr/gerry/letr.1 
Press <RETURN> 
When prompted to <RETURN> to continue: 


‘Press <RETURN> 
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To restore selected files from your backup, cont.: 


8. If the system prompts you to remove the tape 
Or diskette and insert the next one, make sure 
you are inserting them in the correct order, 


9. Repeat Steps 7 and 8 for files you wish to 
restore from your other backups. 


19. When the system prompt returns, you can log 
off or enter another command. 


9-5 REPAIRING FILE SYSTEM PROBLEMS 


Performing recommended start up and shut down procedures 
every day reduces the number and severity of any file 
System problems you may have. | 


When starting up or shutting down, your system performs a 
file system check. If there are minor inconsistencies in 
the file system, the system corrects them automatically. 


However, if serious file system problems are detected, you 
must call your technical representative for assistance in 
diagnosing and correcting the problems. System messages 
instruct you to call for assistance and to log on the 
system as the maint user. | 


Operating as the maint user allows the system 
administrator to perform file System repairs ina safe 
environment, But, ONLY YOUR TECHNICAL REPRESENTATIVE IS 
QUALIFIED TO DIRECT YOU IN THE REPAIR OF YOUR SYSTEM, 


The maint user account has its own password, though its 
user ID (UID) is the same as root's, zero, (@). The maint 
user is shipped with the password "secret." We recommend 
you change it, and tell the new password to only a few 
trusted individuals. (See 7.7 to change passwords.) 
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When you log on the system as maint, this message appears: 


This login is to be used ONLY for filesystem 
maintenance. If you are here because of a filesystem 
error detected by either the RC file or shutdown, call 
your technical representative before continuing. 


To speed the diagnosis and repair of your file system, 
note down the error messages that appear on the screen (if 
they are not automatically printed out on the Shutdown 
Status Sheet). Have the error messages and your Shutdown 
Status Sheets handy when you call for assistance. 


Note down all the steps your technical representative 
instructs you to perform. If similar problems occur more 


than once, you may be able to use your notes to repair the 
file system without assistance. 
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section 6 


EVENTIVE MAINTENANCE 


6.1 INTRODUCTION 


It is the responsibility of the system administrator to 
Maintain the system in good working order. This means 
performing the periodic preventive maintenance listed below: 


Section 
Number 


6.2 
6.3 
6.4 


6.5 


CIE SYSTEMS REGULUS 


Preventive Maintenance Task 


Hardware preventive maintenar.ce 
Replace cartridge tapes and diskettes 
Review the Shutdown Status Sheet 


"Clean out" your directory entries 
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6.2 HARDWARE PREVENTIVE MAINTENANCE — 
In addition to your other duties, it is the responsibility of 
the system administrator to perform periodic preventive 
hardware maintenance. These duties take very little time, but 
can prevent serious and costly problens. 
Table 6-1. Preventive Hardware Maintenance. 
DEVICE REOUT RED MAINTENANCE 
MAINTENANCE SCHEDULE 
Diskette drive Clean heads 3 - 6 months 
Streamer tape drive Clean heads 8 hours of usex 
and capstan 
Printers Vacuum When paper particle 
accumulation is 
apparent 
(%*% see 6.2.2.1) 
a. 
Log all preventive hardware maintenance you perform on your 
Shutdown Status Sheet under "Comments". 
NOTE 
If you have problems reading to, or writing from, your 
diskette drive or streamer tape, you may have dirty drive 
heads. Clean the drive heads BEFORE you call for assistance. 
YOu May Save yourself time and money. 
NOTE 
Never wear jewelry when cleaning the drive heads or capstan. 
You can damage both the drive and your jewelry. 
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6.2.1 Cleaning Diskette Drive Heads 


Clean your diskette drive heads every three to six months 
Drives used frequently should be cleaned more often than 
drives used less often. 


Use a good quality head cleaning kit with a nonabrasive 
cleaning surface. Follow the instructions that come with 
the kit. 


6.2.2 Cleaning Streamer Tape Drive Heads and Capstan 
You must clean two parts of the streamer tape drive: 
@ Heads 
@ # Capstan 


Figure 6-1 illustrates the inside of the streamer tape 
drive. 


Capstan 
Safety Mechanisms P Read/Write Heads 
| - Tape guide 


Figure 6~1. The Streamer Tape Drive. 
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6.2.2.1 Cleaning the Streamer Tape Drive Heads 


Use the following schedule when cleaning streamer tape 
drive heads AND capstan: 


TAPE AGE CLEANING SCHEDULE 


Brand new After 2 hours of use 


Used After &G hours of use 


Good quality streamer tape drive cleaning kits are 
available. If you use one, follow the instructions 
that come with the kit. 


If you do not have a streamer tape drive head cleaning 
kit, follow the instructions given here. 


NOTE 
To clean your streamer tape drive heads you will need: 
@ Long-handled, lint-free swabs 


@ Head cleaning solution or isopropyl 
alcohol 


NOTE 
The streamer tape drive opening is very narrow. Be 


careful when maneuvering your fingers and swabs in the 
drive. 
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NOTE 


Clean the heads and capstan SEPARATELY. Do NOT clean 
the capstan with cleaning solution or alcohol. 


1. Dip a swab into your cleaning solution or alcohol. 
Gently and thoroughly rub the entire head and tape 
guide surfaces (but NOT the capstan) with the swab 
(see Figure 6-1). 


2. Take a clean, dry swab and rerub the head and tape 
guide surfaces to remove any possible residue left 
by the cleaning solution or alcohol. 


3. Log the cleaning on your Shutdown Status Sheet. 


4. Use the streamer tape drive as needed. 
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6.2.2.2 Cleaning the Streamer Tape Drive Capstan 
To clean your streamer tape drive capstan you need: 
® Long-handled, lint-free swabs 


@® Water (preferably distilled water) 


NOTE 


NEVER touch the capstan surface with your fingers. 
You may leave a dirty oil residue. 


Anything other than water may damage the capstan. 


1. Dip a clean swab in water. Gently place the wet 
(but net dripping) swap tip against one side of 
the capstan (see Figure 6-1). 


2. Gently rotate the capstan several times so that 
the entire peripheral surface rubs against the 
damp swab tip. 


3. Log the cleaning on your Shutdown Status Sheet. 


4. Use the streamer tape drive as needed. 
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6.2.3 Cleaning Printers 


Periodically vacuum the paper pieces and dust from your 
printers. It is a good idea to check the printer every 
time you change the printer ribbon. That way you can 
monitor the amount of paper dust. 


Before you vacuum a printer, turn the printer off AND 
disconnect the power cord. Use a vacuum with a wr 
nonmetallic nozzle. 
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6.3 REPLACING CARTRIDGE TAPES AND DISKETTES 


Cartridge tapes and diskettes need replacing infrequently, 
usually only when there is obvious evidence of wear, 


If a tape or diskette is "bad", you will usually notice 
problems as soon as you use it. Good tapes and diskettes last 
a long time. 


Often when a tape or diskette is suspected of going “bad", the 
drive is dirty and is causing the problem. Clean the drive 
BEFORE replacing the tape or diskette. 


Protect your tapes and diskettes by storing them in the same 
type of environment (temperature, humidity, etc.) as your CIES 
688 system. Make sure you protect your tapes and diskettes 
from any magnetic interference. 


6.4 REVIEWING THE SHUTDOWN STATUS SHEET 


Keeping track of the information reported in the Shutdown 
Status Sheet, 1s one of the best ways of monitoring your file 
system. If you are shutting down and backing up properly, you 
are probably using the shutdown user procedure and getting a 
Shutdown Status Sheet every day. 


We recommend you review your Shutdown Status Sheets once a 
month. 


While it is a good idea to briefly review all the information 
printed on the Shutdown Status Sheet, the two most important 
items to monitor are: 


@ The percentage of used space in the file system 


® Consistently occurring problems 
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6.4.1 Monitoring the Percentage of Used File System Space 


Among other things, the Shutdown Status Sheet reports the 
percentage of used space in the file system. 


Monitor this usage, so that when the used space approaches 
983, you can perform the necessary steps to prevent 
running out of space. 


Keep the percent of used space down so that: 
® You do not run out of file space suddenly 


® Commands which search through the file system 
do not take time searching through unnecessary 
files 


e@ Backups can be kept as small as possible 


If your system approaches 98% used space, there are 
several ways you can regain file system space. The method 
you choose to use depends on your data and how you use 
your system. See 6.5, and follow the instructions in that 
section. 


6.4.2 Monitoring Consistently Occurring Problems 


Tracking problems that occur consistently is useful for 
diagnosing problems, trying to predict when problems will 
occur, and trying to prevent problems. 


Note any patterns of problems you find on your Shutdown 
Status Sheet. 


If you need to call your technical representative for 


assistance, inform that person of the problems you have 
noticed. | 
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6.5 "CLEANING OUT" YOUR DIRECTORY ENTRIES 


In addition to monitoring your file system by reviewing 
Shutdown Status Sheets, it is a good idea to monitor directory 
entries that have not been accessed recently. 


There are no hard and fast schedules for checking directory 
entries. How often you check them depends on how much you use 
your system, We recommend you check your file system every 
two weeks or once a month. 


Monitoring your directory entries means looking through your 
directories with ls -lt to see which files and subdirectories 
have not been used recently. 


For example, to view the directory entries in the /usr/gerry 
directory in chronological order: 


Type: 


Press <RETURN> 


ls -lt /usr/gerry 


The display will look something like Figure 6-2. 


os 


—TW------— gerry 1 Wed Dec 14 12:50 1983 132 begformat 
drwxr-xr-x gerry 2 Thu Sep 6 13:33 1984 336 corres 
~ru-r--r-- gerry 1 Thu Sep 6 11:00 1984 119 draft.lip 
—~rw-r--r-- gerry 1 Wed Sep 5 14:53 1984 1918 obie.doc 
=f See gerry 1 Thu Aug 9 14:06 1984 1746 practice 
—TQ--S=->> gerry 1 Wed Oct 12 13:47 1983 16862 practicel 
=—pPy=S—= gerry 1 Thu Sep 1 12:57 1983 1173 practice2 
—rw-r--r-- gerry 1 Thu Sep 6 10:42 1984 4062 print 
—“ruw-r-~-r-- gerry 1 Thu Sep 6 10:59 1984 4962 print.doc 
druxr-xr-x gerry 19 Wed Aug 22 11:11 1984 4468 rsam 
—~“rw-r-~r--~- gerry 1 Mon Aug 27 16:34 1984 34 test 
Figure 6-2. Directory Entries ~ The ls ~lt Cammand. 
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In Figure 6-2, notice that the date and time of last access is 
listed for every entry. The entries are listed in 
chronological order, with the most recent files at the top of 
the display. 


Look through the displayed list. Review the contents of the 
files and subdirectories that have not been accessed recently. 


Remove from the system any older files that are no longer 
useful. See 6.5.1 for details. 


6.5.1 Removing Unnecessary Files 


Removing unnecessary files increases the amount of free 
space in the file system. 


You can remove files by: 
@® Deleting them (using the rm command) 
@® Copying them to diskettes or cartridge tape 
(using the save command), then deleting them 


(using rm command) 


@® Moving them to another file system (on a 
diskette or another hard disk) 


6.5.1.1 Deleting Files 


Once you have determined that you do not need to keep 
a file, you can delete it, thereby, creating more free 
space in your file system. 


To delete a file, leaving no record or backup of it, 
use the rm command, following the instructions given 
here. 


See on-line documentation under rm (amnd) for more 
information. 


NOTE 


The rm command deletes a file WITHOUT ANY PROVISION 


FOR RECOVERING IT. If you wish to have a copy of a 
file that you want to remove from your system, see 


6.5.1.2 and 6.5.1.3. 
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1. Log on the system as root, using the root 
password. 


NOTE 


Both the owner of a file and root have the ability 
to delete the file. So, you can also log on as 
the owner of the file. 


2. At the prompt, use the rm command in the following 
form: 


rm filename 

For example, to delete the file /usr/gerry/doc.1: 
Type: mm /usr/gerry/doc. ] 
Press <RETURN> 


3. When the prompt returns, you can log out or enter 
another command. 


6.5.1.2 Copying Files to Diskettes or Cartridge Tapes 


You can save copies of files on diskettes or cartridge 
tapes before deleting them from the system using the 
save (for diskette) or save-ct (for cartridge tape) 
commands. | 


This is useful when your file system is crowded and 
you only access some files infrequently. You can 
store the infrequently accessed files on diskettes or 
cartridge tapes, copying them back to the hard disk as 
needed. 
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Typically, there are two standard ways of copying 
files to diskettes or cartridge tapes: 


® Copying a single file 
® Copying a directory and ALL its contents 
(including subdirectories and all their 
contents) 
To copy files to diskettes or cartridge tapes, follow 


the instructions below. For more information on save, 
see the on-line documentation under save (user). 


NOTE 


To copy files to diskettes, you must have formatted 
diskettes that are either blank or can be written 
Over. 


Copying a Single File to a Diskette or Cartridge 
Tape 


ane Gay eae eo CE A CES GE TP ITS CED CGD CAD AED HAD GHD GUND KD GP AG OG CEU GAS COA Cues OD OED ED CD GH Cis ID GO ALD OE GED GD TE STE Cas BD VE CAD EE GEE CHAS CAND SHE CD GETS CRT TEMP 
ORS CED CUD GD ED CD GD GME GLY AMEE GA CR CMR GERD ES LAE OAD ED END OD GERD CE LED OEY COBDS GOD GMD CAI GED GED CID CUD GL COED GLUED CET TAD LY AOD AN ATED GUND ED ASIP GUNES CASED LOM GINS EEEEN cme ema 
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1. Log on the system as root, using the root 
password. 


NOTE 
Both the owner of a file and root have the 
ability to copy the file. So, you can also 
log on as the owner of the file. 


2. At the prompt, change to the directory 
containing the file using the following form: 


cd directoryname 

For example, if the file is in /usr/gerry: 
Type: cd /usr/gerry 
Press <RETURN> 


ane SS CA GED CUP SRLS EE SY CNG SD SAE CMD CN CU COD Gis ESD CA GES CLD EAS ERD GALS RUD GEES GUID ANT SEND WEN) CEED OUED CEM) CHD GL VES KES ESD GED GED ORS SED GND GED CED Gam aes OND me am CD 
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3. Insert your formatted diskette in the diskette 
drive, and close the drive door. 


Or, insert your cartridge tape in the streamer 
tape drive. Make sure the arrow points AWAY 
from SAFE. 


4. At the prompt, enter save or save~ct in the 
following form: 


save filename (for diskette) 
Save-ct filename (for cartridge tape) 


For example, if the file you are copying is 
named doc.1 and you are saving to diskette: 


Type: save doc.1 
Press <RETURN> 

If, however, you are saving to cartridge tape: 
Type: Save-ct doc ed 


Press <RETURND> 


2. A message appears on the screen telling you to 
insert the diskette or cartridge tape and 
press <RETURN> to proceed. 


Press <RETURN> 


6. The system displays the file name after it is 
copied. 


7. The prompt returns when the copying completes. 
You can log out or enter another command. 


8. Label your diskette or tape so you know which 
file you copied. 
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Copying an Entire Directory to Diskettes or 
Cartridge Tape 


NOTE 


Copying an entire directory can require several 
diskettes. Make sure you have enough diskettes 
available before you begin this procedure. 

The du command tells you how much space is 
required to copy a directory. See on-line 
documentation under du (cmnd). 


1. Log on the system as root, using the root 
password. 


NOTE 


Both the owner of a directory and root have 
the ability to copy the directory. So, you 
can also log on as the owner of the directory. 


2. At the prompt, change to the directory you 
wish to copy using the following form: 


cd directoryname 

For example, if you are copying /usr/gerry: 
Type: cd /usr/gerry 
Press <RETURN> 


3. Insert the first formatted diskette in the 
diskette drive, and close the drive door. 


Or, insert your cartridge tape in the streamer 
tape drive. Make sure the arrow points AWAY 
from SAFE. 


continued ----> 
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4, At the prompt, enter save or save-ct and the 
directory name. For example to copy to 
diskettes: 


Type: Save /usr/gerry 
Press <RETURN> 

To copy to cartridge tape: 
Type: Save-ct /usr/gerry 
Press <RETURN> 


2. A Message appears on the screen telling you to 
insert the diskette or cartridge tape and 
press <RETURN> to proceed, 

—— Press <RETURN> 


6. The system displays the name of each file as 
it is copied. 


7. I£ the system beeps and the message 


Tar: remove volume #1 and insert volume #2 
Press <RETURN> to continue, X to abort. 


displays, remove the first diskette or tape, 
and put in the next one. 


Press <RETURN> 


8. Steps 6 and 7 repeat until the system prompt 
returns. 


9. The system prompt returns when copy ing 
completes. You can log out or enter another 
command. 


16. Label your diskettes and tapes so you know 
which directory and files you copied. 
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Copying Files FROM Diskette or Cartridge Tape to 
Your File System 


Using the load (for diskettes) and load-ct (for 
cartridge tapes) commands, follow the instructions 
below to copy BOTH single files and entire 
directories back to your file system. 


1. Log on the system as root, using the root 
password, 


NOTE 


Both the owner of a file or directory and root 
have the ability to copy the file or 
directory. So, you can also log on as the 
owner of the file(s). 


2. At the prompt, change to the directory you 
wish to copy the file or subdirectory into: 


cd directoryname 


For example, if you are copying into 
/usr/gerry: 


Type: cd /usr/gerry 
Press <RETURN> 


3. Insert the first diskette in the diskette 
drive, and close the drive door. 


Or, insert your cartridge tape in the streamer 
tape drive. 
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To copy files from diskettes or tapes, continued: 


4, At the prompt, if you are copying from 
diskettes: 


Type: load 
Press <RETURN> 


If you are copying from cartridge tape: 
Type: load=ct 
Press <RETURN> 


4. A message appears on the screen telling you to 
insert the diskette or cartridge tape and 
press <RETURN> to proceed. 

Press <RETURN> 


aan 5. The system displays the name of each file as 
it is copied. 
6. If the system beeps and the message 


tar: remove volume #1 and insert volume #2 
Press <RETURN> to continue, X to abort, 


displays, remove the first diskette or tape, 
and put in the next one. 


Press <RETURN> 


7. Steps 5 and 6 repeat until the system prompt 
returns, 


8. The system prompt returns when copying 
completes. You can log out or enter another 
command. 
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6.5.1.3 Moving Files to Another File System 
Another method to keep files available and still 
remove them from a full file system is to move the 
files to ANOTHER file system, 


To do that, you must have already created and mounted 
the other file system as detailed in 7.14. 


Once you have mounted another file system, you can 
move files to using the mv command. (See on-line 
documentation under mv (cmnd).) 


BE SURE TO SPECIFY THE CORRECT DIRECTORY WHERE THE 
ADDITIONAL FILE SYSTEM IS MOUNTED. 


a 


ee 
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. 7.1 INTRODUCTION 
This section discusses the special procedures listed below: 


Section 
Number Topic 


Yew Installing and updating REGULUS software 
tes Installing additional software 

7.4 Performing an Initial Program Load (IPL) 
tad Adding users to the system 

706 Adding or changing user groups 

tat Adding or changing user or group passwords 
tn Managing the spooler 

12 Changing file mode 

7.18 Changing file ownership 

7.11 Terminating executing tasks 

VaelZ i 

7.13 Adding printers 

7.14 Setting up and mounting additional file systems 


7.15 Alternate tracking for the 84 megabyte hard disk 
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7.2 INITIALIZING AND UPDATING REGULUS SOFTWARE 


When we say "initialize REGULUS" we mean load the REGULUS 
software onto your system for the FIRST time. By "updating 
REGULUS" we mean to load a more current version of REGULUS 
onto a system that already has REGULUS running. 


There are three separate sets of REGULUS software to install 
and update: 


1. REGULUS Kernel ~ Diskettes B through D 
2. REGULUS Utilities 
3. REGULUS On-Line Documentation 
Most software packages from CIE Systems are shipped with 


installation instruction cards. You may use the cards, or you 
may follow the instructions below. 


7.2.1 Installing and Updating the REGULUS Kernel 


Install the REGULUS Kernel set according to the 
instructions on the installation card or follow the 
procedure below. 


Two portions of the installation procedure require input 
from you: 


@ The bad block portion 
@ The configuration portion 


During the bad bloc 

k portion, the system prompts you to 
enter the head and cylinder combinations listed in the 
Media Defect List that came with your system in the 
OPENFIRST envelope. (Keep the Media Defect List in this 
binder under the OPENFIRST section. 
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The configuration process sets up REGULUS for the 
peripherals you have on YOUR system. The screen will 
prompt you to enter: 

e The number of terminals 

@ The number of hard disks 

@ The number diskette drives 

@ The number of streamer tape drives 


@® The number of magnetic tape drives 


MAKE SURE YOU HAVE THE MEDIA DEFECT LIST BEFORE BEGINNING 
THE INSTALLATION PROCEDURE. 


1. Make sure the system power (including the peripheral 
enclosure) is ON. See your Installation Manual for 
details. 


2. Insert diskette A (the Self Boot Diskette) in the 
diskette drive (label side up and towards the drive 
door). Close the drive door. 


3. Press the IPL switch. 


4, When this prompt appears: 
Please specify boot device 


Respond with: 


Type: f£ 
Press <RETURN> 


5S. Instructions for loading the system display on the 
screen. Follow these instructions to complete the 
installation. 


6. When you have finished installing REGULUS, you may 
install additional software. Use the instruction card 
provided with each software package or follow the 
instructions below. 
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7.2.2 Installing and Updating Utilities and Documentation 


Install and update the REGULUS Utilities and Documentation 
sets as you would other additional software. See 7.3 for 
instructions. 


7.3 INSTALLING ADDITIONAL SOFTWARE 
All CIES software designed to run under REGULUS is also 


designed to install via the Software Installation Procedure 
(SIP). 


7.3.1 Installing Software to Run under REGULUS 


1. Log on the system as the install user. 


Enter your system's install user password. If you have 
not changed the password from the default "secret", 
enter "secret". 


2. The screen displays the following message: 


This is the software installation login. It can 


only be used to install or update software (from 
floppy diskette(s)) on your system. 


Please stand by. Setting up the temporary 
directory. You can 


1, Insert first floppy diskette of an installation 
or update set and press <RETURN> when ready 

2. Press <DELETE> to terminate installation and 
exit immediately. 


4, Insert the first diskette: 
Press <RETURN> 


continued ----> 
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To install additional software under REGULUS, continued: 


9. Follow the installation instructions on your screen. 


The instructions are specific to the software you are 
installing. 


6. When the installation is complete the screen returns 
to the login prompt. 


7.3.2 The Installation History File 


Each installation of software (other than REGULUS) on your 
system is recorded in a file named history. This file 
resides in the /usr/install directory. You may display 
this file and related files by using the more and cat 
commands. 


The history file contains the following information for 
each installed set of software: 


@ Date and time installation attempted 
@ Date and time master software diskettes built 
@® Product and version identification 


DO NOT MODIFY OR EDIT THE SIP HISTORY FILE. This file 
tracks the software revisions installed on your system. 
This information is very valuable during system 
trouble-shooting to diagnose software problems. 
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7.4 PERFORMING AN IPL 


The Initial Program Load (IPL) is an important process that 
the system administrator must perform periodically. If loads 
a program from diskette or hard disk into system Memory. 
Usually, and IPL loads REGULUS. Sometimes this procedure is 
called "booting" or "resetting". 


The different kinds of software that can be loaded by IPLing 
are: 


@ Operating systems 
® Utility programs 


@ Diagnostic programs 


NOTE 


IPLing terminates all tasks. If users are still logged on the 


system, if files are open, or tasks in progress when an IPL is 

performed, your file system may become unreliable and you may 

lose valuable data, ONLY PERFORM AN IPL WHEN ALL OTHER USERS as 
ARE OFF THE SYSTEM AND ALL OTHER TASKS ARE COMPLETED. 


We strongly recommend you perform an IPL by using the REGULUS 
shutdown command or by logging on as the shutdown user. 

Before performing an IPL, both the shutdown command and 
shutdown user procedure bring the system safely down by 
logging off any other users and terminating active tasks. The 
shutdown user is discussed in Section 5. For more information 
on the shutdown command, see on-line documentation under : 
shutdown (maint). 


See Figure 3-13 for a complete, yet brief description of the 
IPL process when REGULUS is loaded into memory from the hard 
disk. 


Occasionally, you may need to perform an IPL without using 
shutdown procedures. For example, you MUST IPL if the system 
goes down unexpectedly. In such cases, follow the procedure 
below. 
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7.4.1 Performing an IPL without Using shutdown Procedures 


NOTE 


These instructions assume you are IPLing because your 
system went down unexpectedly. 
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To IPL without using shutdown procedures: 


1. Press the white IPL switch on your system. 


On most CIES 688 systems the IPL switch is located on 
the front of the main enclosure. However, on the 
680/28 the IPL switch is on the back of the console. 


2. The following message appears: 
Please specify boot device 
This question asks you which device you wish to load 


software from. There are four ways you can respond to 
the above prompt: 


Response Meaning 
<RETURN> Default response. Load 


software from whatever hard 
disk is on the system. 


<f> <RETURN> Load software from the diskette 
in the diskette drive. ) 


<w> <RETURN> Load software from the hard 
disk. This response is only 
applies to 680/20s, 680/30s 
and 689/100s (10 and 46 hard 
disks). 


<s> <RETURN> Load software from the hard 
disk. This response is only 


applies to 680/35s, 680/4@s, 
and 689/288s (84 MB hard disk). 
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4. Enter one of the responses described in Step 3. 


To load REGULUS from the hard disk (the most carmon 
response) : 


Press <RETURN> 


5. The IPL program proceeds until software has been 
loaded. 


If you are loading REGULUS from the hard disk, the 
IPL process continues until the system comes up in 
multi-user mode. 
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7.4.2 IPL Errors 


If an IPL is not successfully completed, it is usually 
possible to determine the problem. 


If you make an invalid response to the boot device prompt, 
the prompt continues to display until you make a valid 
entry. 


If the debugger prompt "B 1.2" appears, then possibly: 


@ A memory pattern test has failed (see Figure 
3-4 for memory test messages) 


@ The boot device specified may not be connected 
to the system 


@ Power may not be applied to the main or 
peripheral enclosures 


Press IPL and try again. If necessary, turn the power off 
and on; then press IPL again. (To power down, press the 
POWER switch in the peripheral enclosure. THEN press the 
POWER switch on the main enclosure. Wait several minutes 
before powering up again to allow the hard disk time to 
stop spinning. To power up, press the POWER switch on the 
main enclosure. THEN press the POWER switch on the 
peripheral enclosure.) 


Do this several times until an IPL is successfully 


completed. If you are still unsuccessful, call your 
technical representative. 


725 ADDING USERS TO THE SYSTEM 
By convention, ordinary REGULUS users have: 
@ A home directory of /usr/username 
@ A unique user ID (UID) 
® /bin/sh as the default shell program 


Most user accounts created by the system administrator use the 
above conventions. 


To create new user accounts, operate as the root user, using 
the adduser command. 
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There are nine parameters used with adduser which reflect the 
conventions listed above: 


Parameter 


username 


—pass 


—-nopass 


~uld 


-home 


-silent 


~noback 


Meaning 


Name of new user -- must be specified. 


Optional. Add a password -- either -pass 
Or —-nopass must be specified. 


Optional. No password for this user. 


Optional. User ID number -- if not given, 
adduser assigns the next unique number. 


Optional. User’s home directory -- if not 
given,» the directory is created by 
prepending "/usr™“ to the username. 


Optional. User’s group ID number -- if 
not given,» will be @. 


Optional. The shell program the user wil} 
use -- if not given, defaults to /bin sh. 


Optional. Run addusger without messages. 


Optional. Do not produce a backup copy of 
/etc/ passwd. 


All adduser parameters are optional except the user name. YOU 
MUST SPECIFY THE USER NAME immediately after “adduser". 


If you wish to use any of the other parameters, leave one 
Space after the user name, enter the parameter followed by one 
Space and the value (or meaning) you wish to give the 


parameter. 


You may use aS many parameters as you wish; always 


leave one space between a parameter name and the words before 
and behind it on the command line. 


See on-line documentation under adduser (amnd) for details 
about adding users to the system. 
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NOTE 


The commands dspuser (display user) and upduser (update user) 
are useful when setting up and changing user accounts. See 
on-line documentation under dspuser (cmnd) and upduser (annd) 
for details. 


1. Log on the system as the root user, using the root 
password. 


2. At the system prompt: 
Type: adduser username 
Press <RETURN> 


The above adds a conventional user with no password to the 
system. 


Or, to add a user account using adduSer parameters, at the 
system prompt: 


Type: adduser username -paraml valuel -param2 ... 


Press <RETURN> 


3. When the system prompt returns, the user account has been 
created. You can log off or enter another command. 
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7.6 ADDING A USER GROUP 


User groups are maintained through use of the /etc/group file. 


Because each business's security needs are different, REGULUS 
comes without any groups set up (i.e., without an /etc/group 
file). You may use REGULUS without ever creating user groups. 
But, if you wish to limit access to certain files to certain 
users, you May want to create and maintain user groups. 
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Login aS root. 

Change to the /etc directory. 
Type: cd /etc 
Press <RETURN> 


If you already have an /etc/group file, edit the file to 
add the new group. If no /etc/group file exists, create 
one. In either case: 


Type: ed group 
Press <RETURN> 
At the ed prompt (see Appendix C): 


pe: a 
Press <RETURN> 


You may now add new information to the /etc/group file. 
Add one set of new group information per line. Each item 
is separated from the next by a colon (:). 


For example, to add a user group named administration with 


a GID of 5: 


Type: administration::5: 
Press <RETURN> 
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Each set of group information MUST appear in the following 
order: 


1. The group name. The system administrator 
specifies this. 


2. Optional encrypted group password. REGULUS enters 
this information when a password is created using 
the passwd command (see 7.7). 

3. The group ID (GID) number. The system 


administrator chooses a unigue number to enter as 
the GID. 


If you make a typing error, use the <back space> key to 
make corrections BEFORE you press <RETURN> for the line. 


6. When you are finished adding user groups: 
Press <RETURN> 
Then, 


Press <.> 
Press <RETURN> 


7. At the ed prompt: 


Press <RETURN> 


8. The system prompt returns when you have finished editing 
or creating /etc/group. 


9. If you wish to add a group password, use the passwd 
command as explained in 7.7. 


CIE SYSTEMS REGULUS 7-13 SYSTEM ADMINISTRATOR'S MANUAL 


Section 7, Special Procedures 


NOTE 
To delete a group from the /etc/group file, use the ed program 


(see Appendix C) and delete the line in /etc/group on which 
the group is listed. 


NOTE 


To make full use of your new user groups, change the group's 
file mode to limit the file access of nongroup users, using 
the chmod command. See 7.9 chmod information. 


7.7 ADDING OR CHANGING USER OR GROUP PASSWORDS 
The passwd command lets a user add or change his own password 
whenever he desires. The system administrator Operating as the 
root user may also use passwd to change ANY user's or group's 
password, including the root password, 
A password must be at least four characters and no more than 
Six. See the discussion of passwords in Appendix E. On-line 
documentation is available under passwd (amnd). 
This discussion covers the following cases: 

@® A regular user adding or changing his own password 


@ The root user adding or changing a USER password 


@ The root user adding or changing a GROUP password 
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7.7.1 How a Regular User Adds and Changes His Own Password 


1. Log on the system. 


2. At the prompt: 


Type: passwd 
Press <RETURN> 


3. If you are CHANGING a password, the system prompts for 
the old password: 


Enter the password you are changing. 
Press <RETURN> 


4. If you are ADDING or CHANGING a password, the system 
prompts for the new password. 


Enter your password. 
Press <RETURN> 


The system prompts you to enter the new password 
again: 


Enter your paSSword again, exactly as above. 
Press <RETURN> 


5. When the procedure is finished, the system prompt 
appears. You can log off or enter another command. 
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7.7.2 How the root User Adds or Changes a User Password 


Log on as the root user, using the system's root 
Password. 


At the prompt: 
Type : passwd username 
Press <RETURN> 
The system prompts for the new password, 


Enter the new password. 
Press <RETURN> 


The system prompts you to enter the new password 
again: 


Enter the new password again, exactly as above, 
Press <RETURN> 


When the procedure is finished, the system prompt 
appears. You can log off or enter another command. 
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7.7.3 Adding and Changing Group Passwords 


NOTE 


This procedure is rather different than the procedures for 
adding or changing user PASSWORDS. It requires that you 
add an already encrypted version of the password to the 
/etc/group file. Read the following instructions 
carefully BEFORE you begin. 


1. Log on as the root user, using the root password. 


2. Temporarily change an existing user password to 
the password you wish to use for your group. 


Follow the instructions given in 7.7.2. 


3. Display the /etc/passwd file, and note down the new, 


encrypted password. To do this, enter the following 
at the system prompt: 


Type: cat /etc/passwd 


Press <RETURN> 


The encrypted password is located between the first 
and second colons (:) for that entry. 


4. Change the user password back to its original. Again, 
follow the instructions in 7.7.2. 


9. Add the encrypted group password to /etc/group, using 
the ed command. At the system prompt: 


Type: ed /etc/group 


Press <RETURN> 
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6. Display the contents of the /etc/group file. At the 
ed prompt (see Appendix C), enter "1" (one) : 


Type: 1: 
Press <RETURN> 
7. Locate the line containing the proper group. Using 
the ed and line editor commands described in Appendix 
C, retype that line adding the encrypted password 
BETWEEN the first and second colons (:). 


For example, if the line you need to edit originally 
looks like this: 


accounting::3 
And, if your encrypted password looks like this: 
YbgS4?av5! 
You must edit the line to look like this: 
accounting : YbgS4 ?av5! 3:3 
8. When you are finished editing, at the ed prompt: 


Type: wq 
Press <RETURN> 


9. The system prompt appears when the task completes. 
You may log out or enter another command. 
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7.8 MANAGING THE SPOOLER 


Your system administrator duties include managing the files 
that are sent to the spooler for printing. 


When we speak of the "spooler" we mean the program /bin/lpr 
which puts files into the spool queue, the directory 
/usr/spool/lpr. Spooling insures that files print out in an 
orderly manner; files are printed in the same order they are 
sent to /usr/spool/lpr. 


REGULUS sequentially numbers the printers on the system. See 
7.13.1 for more information about printer numbers, 


This discussion covers: 
@ Printing a file 
@ Viewing the contents of /usr/spool/lpr 
@ Removing a file from the spool queue 
@ Restarting the spooler 


@ Checking the spooler 


7.8.1 Printing a File 


NOTE 


These instructions assume you know the REGULUS names of 
all your printers. See 7.13.1 to determine printer names. 
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1. Log on the system. 


2. Determine the names of the file you wish to print AND 
the printer you wish to use. 


3. Use the following form to send a file to a printer: 
cat filename | printername 


For example, to print a file name /usr/gerry/myprog on 
a printer named lprl: 


Type: cat /usr/gerry/myprog | lprl 
Press <RETURN> 


4. When the prompt returns the file has been sent to the 
spooler. 


If there are other files already in the spool queve 
waiting to be printed on the specified printer, your 
file waits its turn. 


7.8.2 Viewing the Contents of /usr/spool/1pr 


It is useful to view the contents of the Spool queue to 
See how many files are in the queue to be printed. 


The lpg (line printer queue) command displays the contents 
of /usr/spool/lpr, the files' owners, and their printing 
Status. Figure 7-1 is an lpg display. 


User Dev Id Size Status Mail File 

FOOL @ a@9127 35472 Print No /usr/spool/ lpr/ptaaQ@127 
gerry 0 a@@129 4923 Queued No /usr/spool/ ipr/cfaaQQ129 
obie 1 b@@134 54783 Print No /usr/spool/ lpr/pfab@@134 


Figure 7-1. Example of an lpq Command. 
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In the above figure, notice that the file names look 
Something like pfaa@@127 or cfaa@@129. A file whose name 
begins with p is currently printing. Queved file names 
begin with c. 


1. Log on the system. 


2. At the prompt: 


Type: lpg 
Press <RETURN> 


3. If there are files in /ust/spool/lpr, a display 
samething like Figure 7-1 appears. 


If the spooler is empty, this message appears: 
print queue empty 


4. When the prompt returns, log off or enter another 
cammand. 


To determined the actual contents of spooled files (which 
are named something like pfba@@128 or cfaa0@739), use the 
head command to display the first lines of the file on the 
screen. 
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1. Log on the system as the owner of the file(s) you wish 
to look at. 


2. At the prompt, enter a command line of the following 
form: 


head filename 

For example, to see the contents of cfaaG@G365: 
Type: head /usr/spool/lpr/cfaaGGG365 
Press <RETURN> 


3. When the prompt returns, you can log off or enter 
another command, 
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7.8.3 Removing a File from the Spool Queue 
YOu can: 
@ Remove queued files from the spool queue 


® Terminate a currently printing file 


7.8.3.1 Removing Queued Files from the Spool Queue 


Use the lprm (line printer remove) command to remove 
QUEVED files from /usr/spool/lpr. 


The lprm command removes queued files for only the 
user. SO, user gerry cannot remove any of user obie's 


queued spool files. However, root can remove anyone's 
files. 


The lprm command prompts you with the spooler name for 
each file and asks if you wish to remove it. Respond 
with "y" to the files you wish to remove and with “hi” 
with those you wish to remain. 
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NOTE 


View the CONTENTS of your spooled files BEFORE using 
lprm so that you know which files to leave and which 
to remove. Use the cat command as described in 7.8.2. 
Note down the SPOOL names of the files you wish to 
remove. 


1. Log on the the system as the owner of the file(s) 
you wish to remove. 


2. At the prompt: 


Type: lprm 
Press <RETURN> 


3. The system prompts you with the spool file names 
of each queued file you own. At each prompt 
respond "y" (to remove the file) or "n" to leave 
the file in the spool queue: 


Respond to the prompt 
Press <RETURN> 


4. When the system is finished prompting, the system 


prompt returns. You can log off or enter another 
command, 
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7.8.3.2 Terminating a Currently Printing File 
Terminating a currently printing file (i.e., stopping 
the print job) is slightly more difficult than 
removing a queued file. 

Use the lpr command with the -k (kill) option. 

Like lprm, lpr works only on YOUR spooled files. So, 


user gerry cannot remove any of user obie's queued 
spool files. However, root can remove anyone's files, 
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1. Log on the system as the owner of the printing 
file you wish to terminate. 


2. At the prompt, enter the command line in the 
following form: 


lpr ~k filename 
For example, to terminate pfaa#@126: 
Type: lpr ~-k pfaa@@126 
Press <RETURN> 
3. When the system prompt returns, wait a few moments 
to see 1f the task stops printing. IF IT DOES 
NOT, use the upper-case ~K option: 
Type: lpr ~K pfaaG@126 
Press <RETURN> 
4. When the system prompt returns and the file stops 
printing, realign the paper on your printer and 
Start up the spooler again by following the 


instructions in 7.8.4. 
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7.8.4 Restarting the Spooler 


To restart files printing from the spooler use the lpd 
command with the restart option. The lpd command 
"unlocks" the spooler and starts up printing again. 
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To restart the spooler: 


1. Log on the system, 


2. At the system prompt: 


Type: lpd restart 


Press <RETURN> 


3. When the system prompt returns, spooled files will 
begin printing in their queued order. 


7.8.5 Checking the Spooler 


If you are having problems spooling files, follow the 
instructions below using the configure and config -r 
commands. Running these commands MAY clear up your 
spooler problems. 
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To check the spooler: 
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1. Log on the system as the root user, using the root 
password. 


2. At the system prompt: 


Type: configure 
Press <RETURN> 


If configure finds problems, explanatory messages 
display. Note these down. 


continued -=—=—> 
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3. When the system prompt returns: 
Type: config ~r 
Press <RETURN> 
Again, if problems are found, messages display. 
4. When the system prompt returns, try using the spooler 
again. If problems remain, call your technical 


analyst for assistance. 


7.9 CHANGING FILE MODES 


A file's mode specifies the usage rights for that file. A 
file's mode consists of 18 permission bits. Permission bits 


define: 
@ Read (r) -~ you can view a file, but not modify it 
@ Write (w) ~~ you can create, change, or delete a 
file 
a Execute (x) ~~ this should only exist on files 


containing instructions or commands ; you can 
execute instructions and commands in a file 


rights for: 
@® The file's owner 
@® The owner's group 
@e All other users 


To display the usage right for the files in your present 
working directory, use the ls command with the -1l option: 


Type: ls ~l 


Press <RETURN> 
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Figure 3~5 explains the ls -] display. 
The default mode for nonexecutable files looks like: 
~YW~r~Xr~-x 
It means: 
@ Owner has read and write permission 
@ Owner's group has read permission 
e@ All others have read permission 
Execute permission on a directory means that the directory is 
Searchable. If you do not have execute permission on a 
directory, you cannot display its contents. 
The default mode for directories looks like: 
~drwxr-~r-~ 
It means: 
@ Owner has read, write, and execute permission 
@ Owner's group has read and execute permission 


@ All others have read and execute permission 


the first permission bit of a file mode specified the type of 
file. Table 7-1 illustrates this. 


Table 7-1. First Permission Bits. 


FIRST PERMISSION 
BIT SYMBOL MEANING 


Plain or executable file 
Directory 
Special block file (only in /dev) 


Special character file (only in 
/dev) 
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7.9.1 How to Change File Modes 


Use the chmod (change mode) command to change a file's 
mode. 


You must be root user to use the chmod command. 


Using chmod, you must specify the following three items in 
the following order: 


1. Users -~ owner/user (u); group (g); others 
(0); or all (a), which includes owner, group, 
and others 


2. Add (+) or remove (-) 


3. Permissions ~~ read (r), write (w), and 
execute (x) 


Here are three examples of chmod command lines: 


Example Meaning 


chmod ugt+x myprog Give the owner and his group 


execute permission for the 
file named myprog. 


chmod o-W myprog Deny all others write access 


for the file name myprog. 


chmod a+r myprog Give read permission for the 
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file name myprog to everyone 
on the system. 


Log on the system as root, using the root password. 


At the prompt: 


Enter your chmod command line, as described above. 
Press <RETURN> 


When the prompt returns, the file's mode has been 
changed. You can log off or enter another command. 
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7.1@ CHANGING FILE OWNERSHIP 


When you create a file, its owner is the current user, not the 
owner of the present working directory. 


To display the owner of the files in your present working 
directory: 


Type: ls ~-l 

Press <RETURN> 
See Figure 3~5 for an explanation of the ls ~1 display. A 
file's owner can display as either the user name or the user 


ID (UID) (these are equivalent.) 


Use the chown (change ownership) command to change a file's 
owner. : 


For more information see the on-line documentation under chown 
(cmnd). 


Only the root user can use the chown command. 


NOTE 


To change a file's owner, you must specify: 


l. The new owner's user name 


2. The file name 
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1. Log on the system as the root user, using the root 
password. 


2. At the prompt, enter "chown" followed by the new owner 
name and the file name. For example, to make user obie 
the new owner of the file /usr/gerry/myprog: 


Type: chown obie /usr/gerry/myprog 


Press <RETURN> 


3. When the prompt returns, the task is completed. You:can 
log off or enter another command. 
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7.11 TERMINATING EXECUTING TASKS 


Occasionally, it is necessary to terminate an active task, 
using the kill command. 


The root user can use the kill command to terminate any user's 
tasks. Each user can use kill to terminate his own tasks. 


The kill command requires that you enter the correct process 
ID (PID) of the task you wish to "kill". The instruction 


below include displaying the process table (with ps ~el) to 
determine the PID. 


For more information see the on-line documentation under kill 
(cmnd) . 


NEVER KILL PID 1! 


Read the following instructions all the way through BEFORE 
performing the tasks. 
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1. Log on as root, using the root password, 
2. Display che process table. At the prompt: 
Type: ps ~el 
Press <RETURN> 
3. Find and note the PID of the process you wish to 
terminate. Use the user ID (UID) and terminal (tty) 
numbers to help you locate the process. 
4. Terminate the process as follows: 
NOTE 
Be careful about which process you terminate. By 
terminating a process, you may also terminate that 
process's children. 
Enter the kill command in the following form: 
kill PID# 
For example, if you wish to kill PID 217: 
Type: kill 217 
Press <RETURN> 
5. Make sure the procedure worked. At the prompt: 
Type: ps ~el 
Press <RETURN> 
6. If the process does not appear, the termination 


Succeeded. You can now log out or enter another 
command. 
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7. If the ps ~el indicates the process was not 
terminated, repeat steps 4 and 5. If the process 
remains active, use the following form of the kill 
command: 


kill ~9 PID# 

Using the same example, to kill PID 217: 
Type: kill ~9 217 
Press <RETURN> 


8. When the prompt returns, you may log out or enter 
another command. 
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7.12 ADDING TERMINALS 


When you initialize or update REGULUS, the config (configure) 
command is automatically run. At that time, you tell REGULUS 
what peripheral devices you have on your system (i.e., you 
configure your system). During the configuration procedure 
you are prompted to enter the number of serial ports on your 


System. This sets REGULUS up to run with that number of 
terminals. 


To add another terminal to the system, after your system is 
configured, use the config command. (See on-line 
documentation under config (cmnd) for more information. 
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1, Place the terminal where you plan to use it. Connect the 
power as detailed in the terminal manual. 


2. Plug the terminal cable into the next available port. 
(Each time you connect a device to a port, connect it to 
the lowest numbered available port.) 


3. Log on the system as the root user, uSing the system's 
root password. 


4. At the system prompt: 


Type: config 
Press <RETURN> 


Your current system configuration displays on the screen. 
It includes the number and type of hard disks, the number 
of diskette and streamer tape drives, and the number of 
tty (terminal and serial printer) devices. 


2. The system prompts: 


Enter number of serial ports 
(press <RETURN> if no change, @ to remove) 


Enter the number of displayed tty devices PLUS ONE (for 
the new terminal you are adding. For example, if you have 
five tty devices and you wish to add another, enter "6". 


Type your response 
Press <RETURN> 


6. The system then displays a series of prompts which allow 
you to change the number of other peripheral devices on 
your systen.,. 


If you are not changing the configuration in any other 
way, at each prompt: 


Press <RETURN> 


7. When config finishes, the System prompt returns. You can 
log out or enter another command. 
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7.13 ADDING PRINTERS 


Like terminals, your system is configured for printers during 
REGULUS initialization and updates. 


You can add printers or change printer types AFTER your system 
is configured using the lpconfig command. 


To run lpconfig successfully, you must correctly specify: 
@e What TYPE of printer you are adding or changing 


@ What is the device NAME of the new or changed 
printer 


@ The port number you are adding a printer to ane 
not apply to DMA line printers) 


The lpconfig command recognizes three types of printers. They 
are listed below along with identifying information: 


@ SERIAL printers; connect to terminal ports 


e@ PARALLEL printers; connect to the one 36—pin 
connector available on each communication board 


@ DMA LINE printers; connect to the connector on the 
optional DMA board 


7.13.1 REGULUS Printer Names 

We recommend you follow REGULUS convention when giving 
printers device names. REGULUS names the first printer on 
the system "lpr". For more than one printer, it adds 
identifying numerals to the basic "lpr". For example, if 


there are three printers on the system, REGULUS would name 
the first lpr, the second lprl, and the third lpr2. 


To display the printer device names already in use: 
Type: ls /dev/lpr* 


Press <RETURN> 
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The display will look something like the following: 


/dev/lpr 
/dev/lprl 


If you are adding a printer, count the number of lprs 
displayed. The name you specify for lpconfig will be the 
highest displayed lpr plus one. Using the above display 
aS an example, when adding a printer you would specify the 
printer name as lpr2. 


7.13.2 Adding Printers 


The lpconfig command for each type of printer is slightly 
different, so three sets of instructions follow. 


NOTE 


When indicating a printer device name, the instructions 
use "x" to indicate the number attached to mers 


7.13.2.1 Adding a Parallel Printer 


NOTE 


Parallel printers can only be connected to systems 
with asynchronous communication boards. Systems 
having only CDC boards cannot run parallel printers. 


Each asynchronous communications board has one 
parallel port. Since there is a maximum of four 
communication boards per system, a system can have no 
more THAN four parallel printers. 


To add a parallel printer to a system, you must 
Specify which parallel port number to use. The 
parallel port number is the same as the communication 
board number that the port is on. The first board is 
called board zero, (@). 
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1. Make sure you are adding a parallel printer. The 
printer cable must connect to the 36~pin connector 
labelled "printer" on the back of the system. 


2. Connect the printer cable from the printer to your 
parallel port. Make sure you note the parallel 
port number; you will need it later. 


Also, connect the power cable from the printer to 
an electrical outlet. 


Turn the printer ON. 


3. Log on the system as root, uSing the root 
password, 


4. To determine the printer device name as descr ibed 
above: 


Type: ls /dev/lpr* 
Press <RETURN> 


Find the highest numbered lpr. Add 1 to that 
number, For example, if lpr2 is the highest 
listed lpr value, your device name is Lpr3, 


9. Execute the lpconfig command in the following form, 


lpconfig ~p lprx xX 

| parallel port number 
new printer number 

lpr = basic device name 
parallel printer 

add a printer 


Sn ee 


For example, if you are adding a parallel printer 
tO parallel port 3 and two other printers (lpr and 
Iprl) are already configured: 

Type: lpconfig ~p lpr2 3 


Press <RETURN> 
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6. When the task completes, the system prompt 
displays. 


7. Test the new printer set-up by sending a copy of 


the /etc/passwd file to it (make sure to give the 
correct lpr number): 


Type: cat /etc/passwd | lprx 

Press <RETURN> 
If the /etc/passwd file does not print on the 
newly added printer, check the printer power and 
connections, and try again. If you continue to 


have problems, call your technical support 
representative. 


8. When you verify that the printer works, log off as 
the root user. 


Continue normal use of the system. 
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7.13.2.2 Adding a DMA Line Printer 


NOTE 


DMA line printers connect to the system via the 


connector on the optional DMA board. Only one DMA is 
allowed on a system, so you can have only one DMA line 
printer on your system. 
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Make sure you are adding a DMA line printer. The 
printer cable must connect to the connector on the 
DMA board. 


Connect the printer cable from the printer to your 
DMA printer port. 


Also, connect the power cable from the printer to 
an electrical outlet. 


Turn the printer ON. 


Log on the system as root, using the root 
password, 


To determine the printer device name as described 
above: 


Type: ls /dev/lpr* 
Press <RETURN> 


Find the highest numbered lpr. Add 1 to that 
number. For example, if lpr2 is the highest 
listed lpr value, your device name is iprs.. 


Execute the lpconfig command in the following 
form: 


lpconfig ~d lprx 
| | new printer number 
lpr = basic device name 
DMA line printer 
add a printer 


For example, if you are adding a DMA line printer 
and two other printers (lpr and Iprl) are already 
configured: 


Type: lpconfig ~d lpr2 


Press <RETURN> 
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6. When the task completes, the system prompt 
displays. 


7. Test the new printer set-up by sending a copy of 
the /etc/passwd file to it (make sure to give the 
correct lpr number). Using the above example: 


Type: cat /etc/passwd | lprx 
Press <RETURN> 


If the /etc/passwd file does not print on the 
newly added printer, check the printer power and 
connections, and try again. If you continue to 
have problems, call your technical support 
representative. 


8. When you verify that the printer works, log off as 
the root user. Continue normal use of the system, 
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7.13.2.3 Adding a Serial Printer 


NOTE 


serial printers connect to the system via serial ports 
(the terminal ports). 


The lpconfig command requires that you specify the 
serial port number and the baud rate. 


THESE INSTRUCTIONS ASSUME YOU HAVE A CIES SERIAL, 
PRINTER. If you have another type of serial printer, 
do NOT use these instructions. Instead, determine the 
baud rate that that printer uses, and follow the 
instructions in the on~line documentation under 
lpconfig (cmnd). 


The CIES 3518 serial printer is set~up with a 9600 
baud rate. Other CIES serial printers run with a baud 
rate of 1200. 
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1. Make sure you are adding a serial printer. The 
printer cable must connect to a terminal port. 


2. Do NOT connect the printer cable yet. The system 
will prompt you to do this at the appropriate 
time. 


Also, connect the power cable from the printer to 
an electrical outlet. 


Turn the printer ON, 


3. Log on the system as root, using the root 
password, 


4. To determine the printer device name as described 
above: 


Type: ls /dev/lpr* 
Press <RETURN> 


Find the highest numbered lpr. Add 1 to that 
number. For example, if lpr2 is the highest 
listed lpr value, your device name is ipr3.. 


5. Execute the lpconfig command in the following 
form: 


lpconfig ~s lprx xX 969 
| | baud rate 

port number 
new printer num, 
basic device name 
serial printer 
add a printer 


A Sn ee 


For example, if you are adding a 3510 serial 
printer on terminal port 4, and two other printers 
(lpr and lprl) are already configured: 


Type: lpconfig ~s lpr2 4 969¢ 


Press <RETURN> 
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6. When the task completes, the system prompt 
displays. 


7. Test the new printer set~up by sending a copy of 
the /etc/passwd file to it (make sure to give the 
correct lpr number): 


Type: cat /etc/passwd | lprx 
Press <RETURN> 


If the /etc/passwd file does not print on the 
newly added printer, check the printer power and 
connections, and try again. If you continue to 
have problems, call your technical support 
representative, 


8. When you verify that the printer works, log off as 
the root user. 


Continue normal use of the systen. 
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7.13.3 Changing A Printer Type 


Besides adding printers, lpconfig lets you change a 
printer designation from one type to another. For 
example, if you have one serial printer on your systen, 
you can exchange it for a parallel or DMA line printer. 
You still have one printer, but it is not the same type. 


To change a printer type, use the lpconfig command much as 
yOu would to add another printer. The only difference is 
that the device name you specify must be the device name 
of the printer you are changing. For example, if you have 
one serial printer named lpr, you can switch to a parallel 
printer by following the instructions above for adding a 
parallel printer EXCEPT that you would perform Step 4 to 
See the device name of the printer you are replacing. 
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If you have more than one printer and you are not sure of 
the device name of the printer you want to replace, look 
at the major and minor device numbers for all your 
printers. Major and minor numbers are discussed in 
#0134, 


NOTE 


For details on sending information to the printer, see 
Ved 


7.13.4 Major and Minor Device Numbers 


It 1s useful here to briefly discuss major and minor 
device numbers, These are used to distinguish printers, 
terminals, disks, and other devices on the system. 


The configuration procedure at system initialization and 
update and the lpconfig command set up the correct device 
numbers automatically. But, if there are any printer 
problems, the error messages display these numbers. You 
will need to be able to interpret the numbers to correctly 
interpret the error message. 


Bach peripheral device has its own major and minor 
numbers. 


The major number refers to the actual type of device. 
That 1s, it refers to whether the device is a printer, 
terminal, hard disk, etc. 


The minor number refers to the number of the device. For 
example, terminals and serial printers have the major 
number @. They have the same major number because they 
both connect to terminal ports. The console has the minor 


number §. The terminal or serial printer connected to 
port 1 has the minor number 1, etc. 


To display your system's major and minor device numbers: 
Type: ls ~l /dev 
Press <RETURN> 


Figure 3~8 in section 3 shows an example of an ls ~1 of 
/dev. 
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Table 7~2 indicates the major device numbers for printers, 
Detailed information about device numbers is in the 
online documentation under devices (user). We recommend 
you print out a copy of this on~line help file and keep it 
in this binder under Miscellaneous. 


Table 7~2. Major Device Numbers for Printers. 


Major Number Printer Type 


Serial printers (also 
terminals) 


Parallel printers 


DMNA line printers (a type of 
parallel printer) 


7.14 SETTING UP AND MOUNTING ADDITIONAL FILE SYSTEMS 


Installing REGULUS software creates ONE file system that is 
located on your hard disk. You can set up additional file 
systems on diskettes and additional hard disks. (You can also 
partition a hard disk into more than one file system, but a 
discussion of partitioning is beyond the scope of this 
document. ) 


Once another file system is mounted, access to it is 


transparent. You can access it via the original file system, 
It 1s available under the directory where it is mounted, 


The file system you have "booted" by IPLing is called the root 


file system or /dev/rootfs. The root file system 1s always 
available. You can not mount or unmount it. 
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This discussion includes: 
@ Creating a mountable file system 
@® Maintaining a mountable file system 
@ Mounting a file system 
@ Unmounting a file system 


@ Accessing mounted files 


7.14.1 Creating a Mountable File System 


YOu must prepare any hard disks and diskettes before they 
can be mounted as additional file Systems. They must be 
listed in the /dev directory, formatted, and contain a 
file system. To do this, follow the instructions below. 


NOTE 


If you are creating a mountable file system on a hard 
disk, the formatting portion of the following procedure 
will prompt you for the bad block information listed in 
the Media Defect List for that disk. Make sure you have 
that list available before you begin the procedure. 


NOTE 


You create a mountable file system on a particular device 
only ONCE. After you have created it, you can mount the 
mountable file system whenever you wish to. 
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1. Log on the system as the root user, using the root 
password. 


2. Make the appropriate entries in the /dev directory by 
using the config command. At the system prompt: 


Type: config 
Press <RETURN> 


The system prompts you to verify the number of 
terminals, diskette drives, and hard disks you have. 
If you are creating a mountable file system on an 
additional hard disk, make sure you enter the correct 
number of hard disks. 


When config completes the System prompt appears. 


3. Format the diskette or hard disk you wish to mount. 
To do this, you must specify the device number of the 
diskette or hard disk. 


The device number for a diskette is the number of the 
drive; if you only have one drive, the device number 
for that drive is zero (Q). 


If you are adding another hard disk, the disks are 
numbered sequentially, and the number of the original 


disk is zero (@). So, if you are adding a second hard 
disk, the device number of the new hard disk is one 
(1). 


NOTE 


Write down the device number for this mountable file 
system under the Miscellaneous section in the back of 
this binder. You will need to use this number when 
you refer to this file systen. 
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At the system prompt, enter the appropriate command 
listed below followed by the device number. See the 
example that follows the command list. 


Command Meaning 

fmtflp format a diskette (floppy) 

fmtwin format a 1@MB or 46MB hard disk 
(688/26, /38~-18, /30~46) 
(Winchester) 

fmtfuj format a 84MB hard disk 
(688/35, /36, /40, /46) 
(Fujitsu) 
NOTE 


The first, original hard disk is disk zero (8). The 
second hard disk is disk one (1). The third is disk 
two (2), etc. 


For example, to add a second 46MB disk to your system, 
Type: fmtwin 1 
Press <RETURN> 


The formatting process (i.e., entering cylinder/head 
combinations from your Media Defect List when 
prompted) should take about 308 minutes. When it 
completes, the system prompt appears. 


4. Make a file system on your diskette or hard disk using 
the mkfs command. At the System prompt, enter the 
appropriate command listed below. 


NOTE 


The numbers in the following commands indicate the 
number of blocks the device holds. Make sure you 
enter the numbers EXACTLY. If you enter a larger 
number, an error occurs. If you enter a smaller 
number, the file system you are making will contain 
fewer blocks than it should. 
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NOTE 
The "X" on the end of the device name indicates the 
device number. Instead of X, enter the device number 
you determined in Step 3. 


Command Drive 


mkfs /dev/smdX 139592 84MB 
(680/35, /36, /40/, /46) 


mkfs /dev/winxX 75922 46MB 
(688/30~46) 
mkfs /dev/winxX 16116 10MB 


(688/28, /38~1@) 
mkfs /dev/flpx 64¢ diskette 
For example, to make a file system on the second 46MB 
hard disk on your system: 
Type: mkfs /dev/winl 75922 


Press <RETURND> 


5. When mkfs completes the system prompt appears. 


6. Create or edit the /etc/mountfiles file to include a 
line of information about the file system you just 
created. 


See 7.14.2 below for information. 
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7.14.2 Maintaining a Mountable File System 


Just like your root file system, your mounted file systems 
should be checked for integrity (using the fsck command) 
and for free space (using the df command). 


The system checks your mounted files automatically during 
Start up (through the /etc/rc file) and shut down (through 
the shutdown user procedure), just aS your root file 
system 1s checked, IF YOU ENTER THE PROPER INFORMATION IN 
THE /etc/mountfiles FILE. 


So, you must edit a file named /etc/mountfiles. Each line 
of mountfiles contains: 


@e The name of a mountable file system 

@® The device name for that file system 

@ The directory to mount it under 

® (Optional) "a" indicating to mount the file 
system with the mount all command also checks 


the file system with fsck 


@ (Optional) "SMD=224" if the file system is an 
84 megabyte hard disk 


For details on what /etc/mountfiles must contain, see the 
on~line documentation under mountfiles (files). 


Edit /etc/mountfiles using the ed (editor) command. (See 
Appendix C for ed information.) 
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Figure 7~2 illustrates an /etc/mountfiles example. 


optional mount all and file check flag 


64 MB hard disk flag 
(comment field) 


Space or tab 


/dev/smdl SMD=224 
/dev/flp®@ /usr/gerry/mnt 

/dev/filpl /usr/ languages 

/dev/smd2 /usr/mss SMD=224~--=- 
/dev/smda3 /usr/obie 


Optional file 
check flag 


directory name 
device name 


Figure 7~2, Example of an /etc/mountfiles File. 


Note that the second line of the mountfiles file shown 
above does not have an "a". In this case, /Gev/flp¢@ is 
neither mounted when a mount all conmand is given, nor is 
the file system checked automatically. 


Also note that the last line of mountfiles contains an 
"f£". This indicates that /dev/smd3 has an automatic file 


System check during start up and shutdown procedures, but 
is NOT mounted automatically. 
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7.14.3 Mounting Additional File Systems 


Mount additional file systems using the mount command, 
Using the mount command, you can mount a Single file 
System, or you can mount several file systems at once. 


NOTE 


You can mount file systems manually (i.e., entering 
the specific mount command each time you wish to mount 
file systems), or you can use the /etc/rc file to mount 
file systems automatically. 


To mount file systems automatically, edit the /etc/rce file 
(using the ed command ~ see Appendix C for information) 


adding either: 
@ One line for EACH additional file system 


@ One line for ALL additional file systems if 
they are all to be mounted with every start up 


Examples of the lines to add are given in the manual 
mounting instructions in 7.14.3.1 and 7.14.3.2. pea 


7.14.3.1 Mounting a Single File System 


To mount a Single file system, you must specify the 
name of the device the file system is on, or the name 
of the directory where it is mounted. Device names 


are given above in the discussion on maintaining 
mountable file systems. 


You can mount a file system on any directory. It is 
best to mount it on an empty directory because once a 
file system is mounted on a directory, you cannot 
access any of the files that already exist in that 
directory. 


Only one file system can be mounted in a directory at 
one time, 


By convention, most file systems are mounted on the 


/mnt directory which is empty when no file systems are 
mounted on it. 
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For detailed information about mounting, see the 
on~line documentation under mounting (user). For more 
information on the mount command, see the on~line 
documentation under mount (maint). 


LALO LL NE EY ee LD at Te RD a DD OS AD Ce Cath ls CD A ad SS SD OD IS Sr Sind A PS sd iad Cin Cad an OD Sd Sc and Cd GAD ed Ge a Od nd nd ee Me ue En En ee 
LOLA LL LD LD LD OD CD DD Dd LD OD SD TD TD ld OD ad Cad Ct Cd AD ed LD cD Cd DD id i Se aw ad Se MS MD ad Md Ged Ge On ae ne en 


at GB Ce he Ue 8 PLL SP AS eS et AS I Lt OD a SD SP cd nh ee ls rd Sin ID a A a Sd Cl Cad a Wal Sa a CK iad Cd Ca aa nits nl Wnt Dat ate Cnc td Gacts Ma td a 


1. Log on the system as the root user, using the root 
password. 


2. If you are mounting a diskette, put the diskette 
in the appropriate drive, and close the drive 
door. 


3. The mount command line must include the device 
name and the name of the directory to mount on. 
The command should take the following form: 

mount devicename directoryname 


For example, if you are mounting /dev/smdl on the 
/mnt directory, at the system prompt: 


Type: mount /dev/smdl /mnt 
Press <RETURN> 
NOTE 


You can enter this line in /etc/re for automatic 
mounting with each system start up. 


4. A message appears telling you the file system is 
mounted. 


9. The task is finished when the system prompt 
returns. You may log out or perform another 
command. 


LO Fe ee SS SS tS 8 BS BF BS HS Dt OS EP SB ed RE ed ed ed et ed ed Cet ed a ed a Ge ed Tn end ct ad i Ws Ge 
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7.14.3.2 Mounting More Than One File System 


To mount more than one file system at the same time, 
use the mount command with the "all" option. This 
Signals the system to look in the file /etc/mountfiles 
to see which file systems are to be mounted. 


Once you create the /etc/mountfiles file (see 7.14.2), 
you can mount several file systems at one time. 


ONO RS OOS RS Oe Ok OS he kt Cd se Co ae ed Oe as Oo Oe Oe er meaner ecesnceces 
Tan ene ee eR Se A SE SA A A SA CA MS A A is a ve re sn mi i ail ns i sa Nl aks Rca ca 


OS SOE Ot OY Ol Oe Ot ee te de Oe ee Re OOS RRS Os ae eens esas erecesececereces 


1. Log on the system as the root user, using the root 
password, 


2. If one of the file systems you are mounting is a 
diskette, put the diskette in the appropriate 
drive, and close the drive door. 


3. At the system prompt: 
Type: mount all .* 
Press <RETURN> 


4. A message appears telling you the file systems are 
mounted. 


9. The task is finished when the system prompt 


returns. You may log out, perform another 
command, or access newly mounted files, 


NOTE 
If you are mounting more than one file system 
everyday, you may wish to add a line in your 
/etc/re file that contains: 


mount all 


ee OL A Se el ate OLS RS at Oe Ot Se OP tC Ot Od ad id ie at a ae an ee oe a os Os oe ee ee eee needs ec 
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7.14.4 Unmounting File Systems 
Use the umount command to unmount mounted file systems, 


The umount command lets you unmount one file system at a 
time, or all mounted file systems at the same time. 


NOTE 


YOu cannot unmount a file system if it is active (i.e., if 
files in that file system are currently in use), or if a 
logged on user is "in" that file system. 


7.14.4.1 Unmounting a Single File System 


LOL NO NS LS et SS Dd Pe Oe ed ad ed dD td ae at Ce Se Da De Sd Se ee TS ae ae Ee Md Sd Od es es Oe Me ee Ot ee ee Os oe oe 
LOLS LA RO RD DS Od ee Le eS Sl St SS Sh Ce Se TS St Sd a A Sd ae Tad id ae ne es Oe Sd ad Md dd Os ee Od ae nn eee 


me re ee es ee ee en LOLS LLL LS SO OD Rel oat Ot SS OD at ot at cd a St OP Se St ae St Ct a a ee ee Med Se Gt Gd Cd Gs ee Ed Os Oe 


1. Log on the system as the root user, using the root 
password command. 


2. At the system prompt, use the umount command and 
the file system's device name in the following 
form: 


umount devicename 


For example, if you are unmounting the file system 
on your second 18MB drive: 


Type: umount /dev/winl 
Press <RETURN> 


3. The system displays the name of the unmounted file 
system, 


4. The task is finished when the system prompt 


returns. You may log out or perform another 
command , 


LOLS SS AD DD eh Oe Oe LD ae dD aS ah ae Ct aD ee a SD SD ad asd net et ad OS 8 SS OS nd ee Od ws Oe ds Oe ee Oe Os a ee Os 
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7.14.4.2 Unmounting All Mounted File Systems 


ee SS OF et et 8 Ot Os es Oe en LOS OS tS CO Ot OA ae Oe Os a ad Od Od Od Hs Oo a as Os ences eres 
Oe Ot tO OO ee Oe Oo se oe ees eee es eeerern en, 
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1. Log on the system as the root user, uSing the root 
password command, 


2. At the system prompt: 
Type: umount all 
Press <RETURN> 


3. The system displays the name of each file system 
aS it is unmounted, 


4. The task is finished when the system prompt 
returns. You may log out or perform another 
command. 


Ce EE Se St ee me Ol i RN a RTRs omnes meriimis aia aaa ilk Gadi hal me ae en eo ance 


7.14.5 Accessing Mounted Files 

Once you mount a file system, the files in that file 
System are as accessible as any other files on your 
system, 

When accessing a mounted file with a full path name, make 
Sure you begin the path name with the name of the 
directory the file system is mounted under. 

For example, if your mounted file System contains a file 


called gerry.doc, and if the file System 1S mounted under 
/mnt, you can copy that file to /usr/gerry by: 


cp /mnt/gerry.doc /ust/gerry/gerry.doc 


Using the same example, if you wish to make a subdirectory 
Called newdir on the mounted file system, use: 


mkdir /mnt/newdir 
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NOTE 


You cannot link between one file system and another. This 
is the only restriction placed on mounted files. 


To determine which file systems are currently mounted: 


Type: mount 
Press <RETURN> 


To work in a directory on a mounted file system, use the 
cd command to change to the mounted directory. 


If you cannot unmount a file system, make sure that you 
are not IN a directory that is mounted. If you are; use 
cd to change to a directory in your root file system 
before unmounting. 
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7.15 ALTERNATE TRACKS FOR CIES 84 MEGABYTE HARD DISKS 


NOTE 


The alternate track discussion below is only pertinent to CIES 
Systems with 84 megabyte hard disks: 


8 680/35 


@ 680/42 


§ 680/206 


Alternate tracking is a method of avoiding bad sections on a 
hard disk. The information that would normally be written to 
those tracks is written to alternate, good tracks. 


REGULUS creates an alternate track table Of all the bad tracks 
and their alternates during system initialization or update, 


Most likely, you will never need to be concerned with 
alternate tracks. However, if you continually see I/O read 
and write errors with the SAME values, some tracks may have 
gone bad. Then, you May need to use the smdalts (SMD 
alternate tracks) command which can: 

e@ Create a new alternate track table 

@® Modify the alternate track table 


& Display or print the alternate track table 


For instructions on uSing smdalts see the on~line 
documentation under smdalts (maint). 


To use smdalts, YOU MUST OPERATE AS THE root USER. 
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USING THE REGULUS LINE EDITOR 
AND ed COMMAND 


C.1l INTRODUCTION 
This sections tells you how to use: 


6 The line editor ~ which edits CHARACTERS in a line 
terminal input 


e The ed command ~ which edits FILES 


The Line Editor 

- The line editor is a feature of the REGULUS operating system 
which lets you modify and edit CHARACTERS through terminal 
input. 


If you enter a long input line on your terminal, and the 
command is rejected because one character is incorrect. The 
line editor lets you correct that one character without 
reentering the entire line. 


The line editor is also used within various commands, such as 
the ed (editor) and the shell history commands. 


THE LINE EDITOR ONLY WORKS ON ONE LINE AT A TIME 


The ed Carmand 


The REGULUS ed command is a line oriented FILE editor. It 
works on an entire file at one time, and is used to create and 
modify files. 


Once ycu have started the ed command, the line editor can be 
used to edit characters within individual lines. 
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NOTE 


A summary of both line editor and ed commands is given in C.4, 


C.2 THE REGULUS LINE EDITOR 


The REGULUS line editor lets you: 


@ Copy 
e@ Delete 
@ Display 


& Insert 


@ Perform miscellaneous functions 


C.2.1 Using the Line Editor 


The line editor is easy to use. To execute a line editor 
command, press and hold <CTRL>, WHILE you press another 
key. For example, to copy one character at a time (using 
the "c" function key), press and hold <CTRL> and then 
press <c>. 


To disable the line editor, see the on-line documentation 
under stty (amnnd), ~ledit option. 


Table C~l lists the most comm-n line editor commands. For 
a complete list, see the on-line documentation under ledit 
(misc). 


In the descriptions, the “old line" is the line that 


appears after you specify a line address. The "new line" 
is the new text you enter. 
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Table C~l1. Common Line Editor Commands, 


<CTRL> TASK 
COPY 
S Copy one character at a time from the Old line to 


the new line (left to right). For example: copy 
over to an error using <CTRL> <c>. enter your 
corrections» then use <CTRL> <f> to copy the rest 
of the line. 


f Copy the remaining characters from the Old line to 
the new line, displaying each character. Then, 
terminate the edit. 


: Copy the remaining characters from the Old line to 
the new line,» displaying each character. This 
does NOT terminate the edit, but leaves you at the 
end of the line. 


O Copy characters from the old line to the new line, 
up to but NOT INCLUDING the next character typed. 
Press <CTRL> <o> and release these keys, then 
enter the character desired. For example, 
pressing <CTRL> <o>, then pressing <b> copies up 
to the next "b" in the old line. 


z Copy the characters from the old line to the new 
line» UP TO AND INCLUDING the next Character 
typed. For example,» pressing <CTRL> <z>, then 
pressing <b> copies through the next "b" in the 
Old line. 


ee Am SA A Sh em ee he nS anh een sans Stes aes es ee mt me me me ee 
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Table C~l1, Common Line Editor Commands, continued: 


<CTRLD> TASK 
DELETE 
t Delete one character at time from the line» left 


to right. This displays % for each Character 
deleted. The text will be closed up automatically 
when you display the line again. 


x Delete characters from the old line, up to AND 
INCLUDING the first occurrence of the next 
Character typed. For example, pressing <CTRL> 
<x>» then pressing <s> deletes through the next 
a ~ ha 


p Delete characters from the old line up to» but NOT 
INCLUDING the next character. For example, 
pressing <CTRL> <p>, then pressing <f>, deletes up 
to the next "ff", 


porn 
a \ 


Back- Delete one character at a time. 
Space 
n Delete one character at a time from both the old 


and new lines. This backspaces the new line 
through all blanks to the first nonblank 
character, then backspaces through all nonblanks 
to the first blank. 


re nm Tee I SR eT re eS ee a i a i a a i a a a el ey se 


INSERTING 
e Turn insert mode ON or OFF. The insert mode lets 
you make insertions (text, Spaces, tab stops, 
etc.) anywhere on a line. Press <CTRL> <e> to 
Start: a "<" appears. Enter the new text, then 
press <CTRL> <e> again: a ">" appears. (You can 


press <CTRL> <f> or <CTRL> <1> to display the rest 
of the line as is.) 
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C.3 THE REGULUS ed COMMAND 


The ed (editor) command is used to create and modify FILES. 


NOTE 


Once you have started the ed command, you are "at" a certain 
line (your CURRENT LINE). Enter ed commands at the ed prompt, 
much aS you enter REGULUS commands at the REGULUS prompt. 


The ed prompt includes your current line number, followed by 
">". For example, if you are on line 46, the ed prompt will 
appear as: 


46> 


This section discusses: 


@® Creating files 


@® Exiting ed and returning to REGULUS 


@® Editing files 


C.3.1 Creating a File with ed 


The ed command creates files in a Special area called a 
buffer. The work you do while in ed can be saved (i.e., 
written to the hard disk with a "yw" command) or not saved 
(1.e., not written to the hard disk). 
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1. Log on the system. 
NOTE 


Files are owned by the login account that created 
them. 


2. If you are not in the directory you wish the file to 
reside in, change to that directory, using the cd 
command. 


3. Create a new file. At the system prompt, use the - 
following form: 


ed filename 
The above line indicates that you wish to use ed with 


the specified file name. For example, to create a new 
file called new.prog, | 


Type: ed new.prog 
Press <RETURN> 


4. You are in the ed command when the system displays the 
ed prompt, 


g> 


The "@" indicates that the file new.prog does not yet 
exist. 


5. To enter text or data, at the ed prompt, 


Type: a 
Press <RETURN> 


("a" is the ed command for append. See Table C~2.) 
The cursor will move to the line below @. 


Type in your information, pressing <RETURN> at the end 
Of each line. 


SLL SLL OO RO tL Sl a hr SO He Me OY oS lt Ot St ae Ce ee at Me MD ot Se Oe Pe es dd id Md ed at Me Mee Se Ms Oa es Ee Od Gs ae ee 


continued ~~~-~> 
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, 


To create a file, continued: 


nO et Ce ee as ee eae ce we he Gad Ons Oe Ot RO a at tt no 
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6. To exit the append command, at the beginning of a 
line: 


Press <.> 
Press <RETURN> 


7. At the ed Prompt, you can exit ed, or you can enter 
other ed commands. 


aaa teeta 


C.3.2 Exiting ed 


After you are finished creating or editing a file, you can 
either: 


@® Save your edit and exit ed 


@ Exit ed without saving your edit 


CeSezed Saving Your Edit and Exiting ed 


FRR Rn neat ee a 


Te memnnctma mane meme me at ate tt te tt et nn re eee ene Rretseseresernoee., 


ea em te a te tt ne ee ee Reem er teen 


2. Type: wq 
Press <RETURN> 


("w" indicates write; "q" indicates quit.) 


3. The system displays the file name and the number 
of lines in the file, 


4. At the system prompt, you can log out or enter 
another REGULUS command. 


ANNA NAR RR Ra as eRe teen eer neennemereser een esmeimrnrnoe se. 
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C.3.2.2 Exiting ed without Saving the Edit 


RODS ee Pel Ce eel LO i iO ae A OP Te esd ED ee at a ale OD ad a Oe Cl Cl CO a Ce OE i Cl el Tid Cl Sd a Sd A ec Rcd Ge Ded Sed Med old Ein) Wd ad Gao ae Omen 
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1. Make sure you are at the ed prompt. 


Ze Type: Q 
Press <RETURN> 


("Q" indicates quit without writing.) 


3. At the system prompt, you can log out or enter 
another REGULUS command. : 


ON OSD OL OD Oe SO ee Oa Cee De Cat Ce ad Cl a eh he ae ae at a Tt a SO Ct OS Ce ad eh cd Ghd nd Cad Ged Cash Gined Cnt Utd Wace Gnd Sas 


C.3.3 Editing Lines within ed 


To edit an existing file, at the prompt use the following —_ 
form: 


ed filename 
If the specified file name already exists, ed lets you 
edit the file. If ed finds that the specified file does 


NOT exist, it creates the file for you. 


When you edit a file using ed, you can use both: 


® The line editor commands 


e The ed commands 


Use the line editor to edit text or data within an 
individual line. Enter line editor commands at the ed 
prompt. 


—— 
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Use ed commands to perform operations on ENTIRE LINES such 
as: 


© Appending 
® Deleting 
@ Inserting 
@® Moving 
@ Copying 


Enter ed commands at the ed prompt. 


NOTE 


Unless line numbers are specified, both the line editor 
and the ed commands refer to your current line. 


Table C~2 lists the most common ed commands and their 
usage. A complete list of ed commands is found in the 
on~line documentation under ed (cmnd) . 
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Table C~2. Common ed Commands and Usage. 


a Append lines of text or data AFTER the line 
specified. For example» "Sa" means to append 
lines after line number 5 and before line number 
6. A lone "a" means to append lines AFTER the 
current line number indicated by the ed prompt. 
To exit append, at the beginning of a line: 


Press <.> 
Press <RETURND> 


1 Insert lines of text or data BEFORE the line 
Bpecified. For example, "5i" means to insert 
lines before line number 5 and after line number 
4. A lone "i" means to insert lines BEFORE the 
Current line number indicated by the ed prompt. 
To exit insert» at the beginning of a line: 


Press <.> 
Press <RETURN> 


DELETE 
d Delete the specified line or range of lines. For 
example, "5,9Sd" means to delete lines 5 through Q. 


"Sd" means delete line 5. 


—V— re ee ae ee cee eee cane cee ene co ce me came a een eee eee mene me ee me ee acco eet ene ene Me Date cee em eee cee ee ee ee eee ee mee ee es ee ee ee ee 


CIE SYSTEMS REGULUS C~1d SYSTEM ADMINISTRATOR'S MANUAL 


Appendix C, Using the REGULUS Line Editor and the ed Command 


Table C~2, Common ed Commands and Usage, continued: 


TS me ae em ee a ce ee ae nS Se em ne ee ee ee ae coe ee 


m Move the specified line(s) to the specified 
location. For example, "6,8m3" means to move line 
6 through 8 AFTER line 3. "9n6O" means to move 
line 9 after line @ (i.e., to be the first line of 


the file). 
t Copy the specified line(s) to the specified 
location. For examples "5,6t17" means to place a 


copy of lines 5 and 6 AFTER line 17. 


——e LS ee ne ce ee ome me ee ee ee ee ee 


/ Search FORWARD (towards the last lines of the 
file) and display the next line containing the 
specified string. The line containing the string 
becomes the current line. For example, if your 
current line 1s 15 and you enter "/abc", the 
Search begins at line 16 and displays the entire 
line containing the first occurrence of "abc". 


? Search BACKWARD (towards the first lines of the 
file) and display the next line containing the 
specified string. The line containing the string 
becomes the current line. For example» if your 
current line 1s 15 and you enter "?abc", the 
Search goes from line 14 towards line 1 and 
displays the entire line containing the first 
occurrence of "abc", 


ee me en en See em Sm ee a eS mh aA a! ty i ni a ls aa ve as ets 
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Table C~2, Common ed Commands and Usage, continued: 


a Vb Cm D aos a cum —— RL RS eS SS Ne ee AS Ne Me OND oy mune cele EE EO ee ce cee cee ome eum one em eee eee we eee ome mee ee cae ce ee 
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e Use the line editor on specified line(s). For 
example, "Se" opens up line 5 to be edited using 
the line editor. 


r Read lines in from another specified file. 
For example» if you enter: 


#r filename 


“os 


A copy of "filename" is placed after the specified 
line (#). If you do not specify a line number; 
"filename" is read in at the end of the file. 


r= Substitute one character or etring for another ‘ 
Character or string. For example, 


5» 7s/this string/that string 


means that in line 5 through 7 replace the FIRST 
occurrence of "that string” with "this string”. 


5» 7s/this/that/g 


means that in line 5 through 7 replace "that" for 
"this" in EVERY occurrence. 


a ae Ta ome EP em GED a aa au eee wee ae come oe —_————— a Ke Ae LT SA eh ey ce oe OMe tee me Sone Mee UE) OD OE eee etme cee nD eee ee ee eee ee mu come quo Gems me eee ee 


p Display specified line(s)., For example, "15,18p" 
means display lines 15 through 18. ("15,18" does 
the same thing.) 


= Display the line BEFORE the current line number. 
This moves you BACKWARD in your file. For 
example, "“-2" means display the second line back 
from the current line number. 


, ie 


—————ee— a a SR eR OY Sam eS Ge emer Su ee ee at re me me mee ee went ie ee ee ee ee 
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Table C~2, Common ed Commands and Usage, continued: 


a Oe a ee 


COMMAND TASK 
DISPLAY 
: Display the next 20 lines AFTER the speci fied 


line. The current line is reset. For example, 
"43:" means display lines 43 through 63. _— 
means display the next 20 lines, moving the 
current line up by 20. 


* Display the 20 lines BEFORE AND INCLUDING the 
specified line. For examples "*" means to display 
the 20 lines preceding the current line number. 

+ Display the line AFTER the current line number. 
This moves you FORWARD in your file. For example, 
"+" means display the next line. 


$ Go to and display the last line of the file. 


NOTE 
The symbols: 
_ - # + $ 


Can be used in combination with other ed commands. 
Here are some examples: 


Example Meaning 
45, $d Delete lines 45 through the 
end of the file. 
4,/7e Edit lines 4 through 7. 
#HHH 
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C.4 SUMMARY OF THE LINE EDITOR AND ed COMMANDS 


You may find the following summary useful as a quick reference 
guide that can be kept near your work station. 


Table C~3. ed and Line Editor Command Summary. 


—er—v—K—V— OL SF SS cS Ge See ce eS eee ee ee ree ee me cee eee eee em ee cen es ees mem a> eee ee 
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a append Appends after the specified line. (ex. 5a) 
d delete Delete specified line(s). (ex. 4,6d) 
1 insert Insert before specified line. (ex. 7i) 
e edit Edit on specified line(s). (ex. 54e) 
m move Move specified line(s) to specified 
location. (ex. 6m9 —- move 6 after 39) 
t copy Copy specified line(s) to specified 
location. (ex. 3t8 - copy 3 after 8) 
7 find Find a string,» searching forward (ex. 6/ab) 
e find Find a strings searching backward (ex. ?xz) 
=) substitute Substitute one string for another. (ex. 
48/a/b —- on line 4 substitute "a" for "b") 
r read Read in another file. (ex. r filename) — 
p display Display specified line. (ex. 4p) 
display Display the previous line (ex. 6-) 
: display Display the next 20 lines. (ex. 45:3) 
# display Display the prior 290 lines. (ex. *) 
+ display Display the next line. (ex. 5+) 
$ display Display the last line of the file. (ex. $$) 
<CTRL> LINE EDITOR COMMANDS 
] copy Copy to the end of the line. 
Zz copy through Copy through a specified character. 
O copy to Copy to a specified character. 
Cc copy one Copy one specified character. 
x delete thru Delete through a specified character. 
p delete to Delete to a specified character. 
t delete one Delete one character. 
e insert Insert character(s) into a line). 
n backspace Backspace without erasing any characters. 
<backspace > Destructive backspace. 
f copy Copy to the end of the line and exit the 


CIE SYSTEMS REGULUS 


line editor. 
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Appendix D 
USING ON-LINE DOCUMENTATION 


D.1 INTRODUCTION 


Your REGULUS diskettes include on~line documentation as well 
as software. These documents explain how to use all the 
REGULUS commands and discuss some important REGULUS topics. 
By having REGULUS documentation on-line, we can keep the- 
documentation as up~to-~date as the software. 


Using the on-line documentation, you can: 


e Find all on-line documentation references to a 
command or topic, using the help command 


@ Display individual documents on your screen, using 
the help command 


® Print individual on~line documents (from the 
REGULUS Reference Manual) on your printer using 
the man (manual) command 


@ Print the entire set or one category of on-line 


documents (from the REGULUS Reference Manual) on 
your printer using the makemanual command 


All on-line documentation is found in subdirectories under the 
/doc/man directory. See Figure 3~4 for a brief explanation of 
the contents of /doc/man. : 


On~line documentation is organized into categories. Each 
/doc/man subdirectory is a documentation category. 


Each set of REGULUS diskettes includes the categories of 
on~line documentation for that software. So, the on-line 
documentation you have on your system depends on the REGULUS 
software you have on your system, 
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The most common categories (1.e., the categories of on~line 
documentation that come with the REGULUS Kernel, Utilities, 
and Documentation diskettes are listed below: 


CATEGORY DESCRIPTION 
usr Introductory user documentation 
Basic commands found in /bin 
Maintenance and system 
administrator commands found in 


/etc 


Miscellaneous REGULUS information 


Descriptions of files 


Hardware devices 


For a list of all possible categories see the on~line 
documentation under help (usr): 


Type: help help usr 
Press <RETURN> 
To see which categories YOU have on your system: 
Type: dir /doc/man 
Press <RETURN> 


Since each document category corresponds to one /doc/man 
subdirectory, every entry in brackets, [], is a category. 


NOTE 


some command and topic names are found in more than one 
category. For example, fsck is under both usr and maint. 


Therefore, when using the help and man commands, specify the 
command or topic AND ITS CATEGORY. If you do not specify the 
category, the categories are searched in the above order, and 
only the FIRST OCCURRENCE of the command or topic is used. 
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NOTE 


Often, the on~line documents refer you to other on~line 


documents for further information. Reading all the referenced 
documents gives you a sense of how REGULUS commands are 
interrelated, 


D.2 FINDING COMMANDS AND TOPICS IN THE ON~LINE DOCUMENTATION 


To determine all categories and references for a command or 
topic (i.e., keyword), use the help command with the ~k 
(keyword) flag. 


To use the ~k option of help, you MUST HAVE RUN the makeperm 
command. The makeperm command creates an index that help -k 
uses to locate on-line documentation. You can run makeperm: 


@ Automatically ~ the system prompts you to run it 
after you load each set of documentation 


@® Manually 
Instructions for finding commands and topics in the on-line 


documentation are followed by instructions for running 
makeperm., 


NOTE 


The following instructions use the fsck command as an example. 
YOu May use any command or topic you wish. 
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1. Log on the system, 

2. At the system prompt : 
Type: help ~k fsck 
Press <RETURN> 


3. The system displays a list of every document relating to 
the keyword "fsck", 


When the system prompt returns, you can enter another 
command or log off, 


ee et a a tt tt tt sh ee OS ee eee eme eee eres erene ee. 


D.2.1 Running makeperm Automatically 


To run the makeperm command antomatically, you must have 
JUST loaded some on-line documentation. 


Ee on ew a ee ae a ah tt a tt Rt a et eo se ee em ee er nr erececes 
ee ee ee ee et ae eR ee ee meer 


SO ae ee tO at at et at tt Ot Oe te ee a ee os ee ee eee, hed Cad Ge? Ghat Gru? Gut Gat Gad 


1. Log on the system as the install user. Install 
software and/or documentation as described in 7.3. 


2. The last prompt of this procedure is: 


Press <RETURN> to execute makeperm or <DELETE> to 
cancel 


Enter your response: 
Press <RETURN> 


3. When the task completes, the login prompt returns. 


8 ee ed et es etd Ot Get Ges ee ed Oe ee a ee ee te tt Ot tH ae ns te ee er es as ao a eos 
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D.2.2 Running makeperm Manually 


You can run the makeperm command at any time. Follow the 
instructions below. 


OR tS OL aed tet el tt te a at Wt at OD Sat St Dd Wess A AP nit a CE i Cnt AP Ud dl i nd id Chk Cad Mh Sk Ct Oe as See Oa cd Sd Ce Gd es Ge Cit Mia Wee ne en ene ee 
Ct Bend Bed Bw CaP Bead Cd Md Chad ht ad LP ee Ce OL Ce OD CO ed Ci Dad ad aD a Wad aed Sed Ca ed Md dD SD ad TD ct TO Ce rh eh ie eh Cad ad Cad Ginsd Gas Girt aS Wad hush Sas td Che asd tina 


OP at Let OD A a ct ad a at Se Oa a ad St aD a at St et Ot St Lt i il Ot i a MC Mt a Ce at Hd aes nd at ad Sad and ad Sed tne tines toad tend tad teas ue ae 


1. Log on the system as the root user. 
2. At the prompt: 


Type: makeperm 
Press <RETURN> 


3. When the prompt returns you can log off or enter 
another command. 


LLL LL LS tO tt te al Oe tt et a OD at a St at Dt a Ot Ot ce 8 8 mn se ce es ret ee ne ns eae we se ne Oe a nn 


D.3 DISPLAYING INDIVIDUAL DOCUMENTS 
To display an individual document on the terminal screen, use 


the help command, and specify the command (or topic) and the 
category. 


NOTE 


The following instructions use the maint Category document on 


the fsck command as the example. You may use any command you 
wish. 
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prs 
To display individual documents on the screen: 
STEP TASK OR COMMENT 
1. Log on the system. 
2. At the system prompt: 
Type: help fsck maint 
Press <RETURN> 
3. The first screen of the document appears with a 
“<continue>" in the lower left corner indicating that 
there is more to the document. 
To display the next screen: 
Press <RETURN> 
4. To display the entire document, continue pressing <RETURN> 
until the system prompt returns. 
9. To return to the system prompt before the entire document -— 
is displayed, enter "q" for quit: 
Press <q 
6. At the system prompt you can enter another command or log 
Out. 
+### 
D.4 PRINTING INDIVIDUAL MANUAL DOCUMENTS 
To print an individual document, use the man command 
specifying the command (or topic) and the category. 
NOTE 
The following instructions use the maint Category document on 
the fsck command as an example. You may use any command you 
wish. 
aie. 
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(eeet tere (Cees Greet Gat Cet Cast haat Gnd Ree Bred Gect Gant Chad Ont Crd (Send Gad 25.00 Cae? Ges? Grae Great Gee Gs Set Cet Ce Ces Rimes Seat Reet Sina? Mae Ca? Red Ged Ged Gra Cad Mee Case Ged Ged Gane Rees Saved Chee? Gees feat Oe Cs Geet Ge Od ‘aad Cred Seat Teast Bnet Grad Cues Od Ga 
Cnet Cues Cnt Cv e Tenet Reed Gas Cees Gest Caet tad Set Cnet Git Crt Cast Gased Ges Sart ee Cae eat Sanat Set Sn Ge Sa St Greet Ca St Saat Wa Mae Chae Cea Ct Ti Ge nt St Get it Cd Cr Ot Cet Ge es Sad ad Mare at See tenes tn tee Gers Gee ep Cant Gee eet Os 


Se ne ae me ee nee ee ace a a at nt a ae et a a tet i et a tt ns nee Oe tt es ne ee ts te es eee ene ee Wo ne ee ee 


1. Log on the system. 
2. At the system prompt: 
Type: man fsck maint | lpr 
Press <RETURN> 


3. When the system prompt returns, you can enter another 
command or log off. 


4. Remove your document from the printer. 


TTS ae me ee ee mae a nt a ae a at ar Ot it tt OO te Ot a ns a tr ts ne et ae se Os Os er te er Oe ee es ee ee ee 


D.5 PRINTING ALL THE ON-LINE DOCUMENTATION 


We recommend you keep a paper copy of all your on-line 
documentation. This gives you an up-to-date, portable REGULUS 
Reference Manual. 


Using the makemanual command, you can: 
@ Print out ALL on-line documentation 


@ Print out all the documentation in one category 


NOTE 


Only the root user can use the makemanual command. 


Using makemanual ties up the printer for long periods of time 
(perhaps hours). If you wish to print out the entire set oa 
on-line documentation, we recommend you print one category 


per evening, after most users are logged off the system (see 
DedeZ) « 
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D.5.1 Printing ALL On~Line Documentation 


NOTE 


Because makemanual ties up the printer for long periods, 
the system asks if you wish to generate a complete set of 
documentation. Enter either "yes" or "no", If you enter 
"no", makemanual terminates. 


1. Log on the system as root, uSing the root password, 
2. At the system prompt: 


Type: makemanual 
Press <RETURN> 


3. The system prompts you: 


Do you wish to generate a complete documentation 
set? 


This is a "yes" or "no" question. 


Type your response 
Press <RETURN> 


4. If you enter "no", makemanual displays: 
Ok... terminating 
and the system prompt appears, 


ieee SIS Terns sie nea ne AE ict ac A dtc 


continued ~~~~> 
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SS OS tt Nt A tt ta et ee os ee ee ener mee 
at Ged Set ted eed ad Cad GB Gad Ged aad Gnd Dad AL LS OL OD OD tt a a Ol i a tt ee a a A i at i i St We Cad Cae ad Md Gd Hd Se Sed ad cae toe Oo ene 


SO Oe aa a al te at at et 8 tt tt tt tt lt ke He es ne ee es Oe es se a ee ee ee 


5. If you answer "yes", the system displays: 
finding documentation directories 


It lists all the documentation subdirectories yYouR 
System has. The display looks something like this: 


-/usr 
. /cmnd 
./dev 
-/files 
-/maint 
./misc 


6. As each file begins printing a message appears which 
looks something like: 


printing adduser 
printing arcp 


7. When all the documentation is printed, the system 
prompt returns. You can log off or enter another 
command. 


8. Remove the documents from the printer. 


ned Cd Chet Cad Gad Ge) Cnet Gt Ghat Mat Ge Oe eat ee OS a Rh ent Re eal Ste Gnas ae al et a Dah at ad et ed Se Cd ah Cad Sw i Ed ee ae id ace ed nd Shaadi ed Wd Nee Sin Sins Wied sd Ci Wad ie 
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D.5.2 Printing One Category of On-Line Documentation 


To print out more than one category of manual 
documentation, repeat the instructions below for EACH 
category. 


NOTE 
The following instructions use the usr category as an 
example. You may use any Category you wish, 


1. Log on the system as root, using the root password, 


2. At the system prompt, enter the makemanual command 
followed by the category name: 


Type: makemanual usr 
Press <RETURN> 


This command line prints all the on~line documentation 
for the usr category. 


3. A message displays the category you entered: 


Generating documentation for class "usr' 


4. As each file begins printing a message appears which 
looks something like: : 


Printing adduser 
printing arcp 


2. When the documentation is printed, the system prompt 
returns. You can log off or enter another command. 


6. Remove the documents from the printer. 


ew ee Oe ee I at Ee Ss OR i Re Re ls a a esa oe ee ok 
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THE /etc/passwd FILE 


E.1 INTRODUCTION 

The /etc/passwd file is an important file for the system 
administrator. It is the key to which users can log on and 
which files they have access to. 


Because it is an important file, we recommend you keep 
up~to~date, on-line and printed copies. 


The file /etc/passwd contains information about valid user 
accounts. It is created when the system is generated and is 
maintained by the system administrator. Four users are 
included in the passwd file when it is generated: root, maint, 
install, and shutdown. 


You can add users, delete users, change passwords and home 
directories using any of the following: 


@ The adduser, dspuser, and upduser commands 
® Editing /etc/passwd with the ed command 


The /etc/passwd file contains the following information for 
each user account: 


l. User name 
2. User password 
3. User ID (UID) 


4. Group ID (GID) 


2. Home directory 


6. Program to use as the shell 
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E.2 USER NAME 


The user name is the name the user enters at the "login:" 


prompt. 


REGULUS differentiates between upper~ and lower~case letters 
in a user name. 


E.3 USER PASSWORD 


Passwords are optional. 
help increase your system's security. 
administrator may assign passwords or 


his own using the passwd command. 
an encrypted version is listed in 
If a user does not have a password 


/etc/passwad. 


NOTE 


We recommend 


using them because they 
The system 

each user may specify 

a user has a password, 


/etc/passwd for security. 
, it is omitted from - 


The root user may enter any regular user's account WITHOUT 
using the user's password. 


Passwords can consist of: 


Letters (lower~ or upper~case) 


Numbers 


Punctuation marks 
Other keyboard symbols 


Control characters 


Any combination of the above constitutes a legal password, 
PASSWORDS MUST BE FOUR TO SIX CHARACTERS LONG. The longer the 


password 1s, the more secure it is. 


You May change passwords as often as desired. The root user 
can change a regular user password at any time. This 
procedure is detailed in 7.7. 
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E.3.1 If You Forget Your root Password ... 


Many system administrator functions can only be performed 
by the root user. If you forget your root password, you 

cannot log on as the root user and maintain your system, 

To remedy the situation, you must: 


1, Boot from a copy of the Self Boot Diskette 


2. Use the ed command to delete the root password 
from the /etc/passwd file 


3. Boot from your hard disk 
4. Log on as root (with no password) 


5. Run the passwd command to create another root 
password 


a ee mw oe PP Ret AP esl rt Da ed Soe Det Cae Coad ast Gea Da eat rat Carat ewes Bt Cee Cad CO Pet TS Cae a aed ead ed Pad Ted Sed at Set Cad Cee Cnet Ged Cet Cand Mes Deed Cd Ged Can? Cah Cd ast Read Cnt Bas Cas Cina Chad Ceed 
ee Ht See ee inet et et Cee ed ae Ce ad Sant CS CS ae ee ond a ond Chae Chee He Alaa nad Ge Eines and Cet Gace Cae re ee ah Cae Ase ae Ct Ot at ad nt Raat Cand ed ed ed Deed Deed Cine ed Tce) Tired aad and Cin Gant Goan 


Pe Rt ee ee es Rit ct Reet Cas Geet at nd ed Cal aS ed ae at CD and ad Ott rah end et DS LD Sd ae ih ee et Cd at Md ed Cd and Ce aw Rad he hs ane Cd eed Ce Hine Cnet a Ce Med nd Gs Gc nad 


1. Log on as the shutdown user to safely bring the system 
down. 


2. Put a copy (that is NOT write~protected) of the Self 


Boot Diskette in the diskette drive. Close the drive 
door. 


3. At the "Please specify boot device" prompt: 
Press <f> 
This boots the file system on the Self Boot Diskette. 


4. Mount your hard disk. In the mount command you must 
Specify YOUR type of hard disk: 


If your system is a... Specify 
6886/28 or 680/36-1¢6 /dev/npl@ 
688/38~46 or 680/100 /dev/atasi@ 
680/35, 680/48, or 688/280 /dev/smd@ 


See ee ee ee ee ee ne a Se at et it a a ae a eh a a ae as ae eR ee es es ee eee ee 


continued ~~~~> 
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LF Fe ed Tt et Met ad ad Pt et eect ed nd ned Ried net Clos it need Cine ct asd Sn Ca Cred edd Dena Dao raed Ce Cad Card Cae Gen at Hed Sed Deed hat Ged Gat Chee Gee Gow Gees Gees Guus Goes ae Qew Geee Get Dw Chad Chet Oued Cee aed ed 


For example, if you have a 680/190: 

Type : mount /mnt /dev/atasid 

Press <RETURN> | 
Or, 1£ you have a 680/200: 

Type: mount /mnt /dev/smd@ 

Press <RETURN> 


5. Invoke the ed command to edit the /etc/passwd file. 
At the system prompt: 


Type: /mnt/bin/ed /mnt/etc/passwa 
Press <RETURN> 

6. The ed prompt will look something like this: 
13> 


At the ed prompt: 


Type: le 
Press <RETURND> 


7. The first line of the /etc/passwd file appears. 
Directly below it, a l appears. These lines look 
something like: 


1 root:V?mehkj~7:0:0:/: 
1 


At the second "]": 


Type: root::@:0:/: 
Press <RETURN> 


SE as 8 Reet et eat in Das Rt Ol at a te OE Re ak es at ee es Ses eee Oe eae Ss es ee es es ee Se Ss es es ee es as Ce es et es es es es aes Se ed net eet Ge es et ed ed Ges ts 


continued ~~~~> 
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8. At the ed prompt ")>": 


Type: wq 
Press <RETURN> 


9. Log off. 
18. Press the IPL switch. 
ll. When "Please specify boot device" appears: 


Press <RETURN> 


12. When the system comes up, log on as the root user with 
no password (i.€., press <RETURN> at the password 
prompt). 


ee 13. Create another root password using the passwd command. 
See on~line documentation under passwd (cmnd). 


eee et Ce Died Dee Cael Bre Cra ad Cat Cat Rand Cred Cie Catt Bt Dest Cea Gna ne Cees? Gad Gra Dard Coad Du Beard eae BaD GaP Brad Cid Cid Cre Chad Pa DD et Ged Gat Cd Bd Gee Geet Dew Chad Dad Teed Da Gar? Case Gees Ge Cod Chad Vit Gand Dus? Gad 


E.4 USER IDS 


Each user is identified by a number, the user ID (UID). It is 
generated by the adduser program when a new user 1s given a 
user account. 


Each ordinary user SHOULD have a unique UID. If more than one 
ordinary user has the same UID, undesirable things can occur. 


However, the root user, install user, maint user, and shutdown 
user all have the same UID of zero, (@). This is because each 
of these have the same “superuser" ability, but each performs 
a different “superuser" function. For example, the install 
user correctly installs new software, but cannot change 
ownership of a user file. 


REGULUS uses the UID to identify ownership of the user's 
files. It is also identifies the owners of: executing tasks. 
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NOTE 


If you have more than one CIES 68@ system, we recommend you 


make the user ID numbers for the same user identical on all 
Systems. If the UIDs are the same, you avoid permission 
problems when copying files from one system to another. 


E.5 REGULUS USER'S GROUPS 


Setting up and using groups is optional. Groups are useful 
for limiting access of specific files to certain users. There 
1S an optional password feature for groups which adds another 
level of security. 


REGULUS 1S initialized WITHOUT any groups set up. The root 
user can create and modify user groups, their IDs, and 


optional passwords. See 7.6 for detailed information on how 
to create groups. 


If no user groups are created, every user belongs to the same 
Group, GID zero, (@). 


E.6 HOME DIRECTORY 


The full path name of the user's home directory is the current 
working directory when the user first logs on. The system 
administrator can change this by operating as the root user 
uSing the upduSer command. 


E./7 PROGRAM TO USE AS THE SHELL 


This is the full path name of the program that is executed 
when the user first logs on the system. The default 
(indicated by no entry) is /bin/sh. See the on-line 
documentation under sh (amnd) for more information. 
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F.1 INTRODUCTION 


As defined in 3.7, REGULUS Environments, an environment is the 
set of conditions under which you operate in REGULUS. 


REGULUS uses a set of default environment variables to create 
each user's environment. 


A user can change these variables at any time to change his 
environment. 


Table F~l presents the default environment variables 
= automatically created for each user. 


Table F~l. Default Environment Variables. 


Environmental 
Variables Value (Meaning) 


HOME Full path name of the user’s 
main login directory. 


Path of directories searched 
when looking for commands to 
execute. 


SHELL Path name of the shell 
program to be executed when a 
shell script is run. 


LOGNAME User’s login name. 


USER The user you currently are 
running as. 


The name of the current 
working directory. 
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Note that environment variable names ALWAYS appear 
capitalized. 


In addition to changing the value (i.e., meaning) of your 


default environment variables, you may create and use other 
environment variables. 


To create and modify environment variables, use the setenv 
(set environment) command. The setenv command lets you do 
three things: 


® Display the current list of environment variables 
and their values 


e Create a new environment variable 


@ Change the value of an existing environment 
variable 


see F.2, F.3, and F.4 for details on these. 


To delete an environment variable, use the unsetenv command as 
described in F.5. 


For more information about environments and setenv, see 
on~line documentation under environment (misc) and sh (cmnd) . 


To create a temporary environment to pass to a particular 


program, use the env (environment) command. See on~line 
documentation under env (cmnd) for details. 
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| F.2 DISPLAYING YOUR ENVIRONMENT 
To display your environment: 
STEP TASK OR COMMENT 
1. Log on the system as the user whose environment you wish 
to display. 
2. At the prompt: 
Type: setenv 
Press <RETURN> 
3. Your environment displays on the screen. 
4. When the prompt returns, you can log off or enter another 
command. 
tH ## 
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— 
F.3 CREATING A NEW ENVIRONMENT VARIABLE 
Follow the instructions below to create a new environment 
variable that will be in affect EACH TIME YOU LOG ON. 
"To create a new environment variable: ~~~~SOSC=~CS 
STEP TASK OR COMMENT = ~~~ ~SSSSCSCSOSS 
1. Log on as the user who is adding an environment variable. 
2. Use the ed command to add a line to either the .login or 
-nshrc file (see Appendix C for details). 
3. On the new line, enter the command in the following form: 
setenv VARIABLENAME variablevalue | 
The environment variable name MUST be capitalized. 
For example, to create a new environment variable that 
defines your terminal as a CIT~1@1: 
Type: setenv TERM citl@l -_ 
Press <RETURN> 
4. Exit ed. You can log off or enter another command. 
nr 77 
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F.4 CHANGING THE VALUE OF AN EXISTING ENVIRONMENT VARIABLE 
Changing the value of an existing environment variable is 
Similar to creating a new environment variable. The setenv 


command line form is identical; you enter an existing variable 
name and a new value for that name. 


SO ee re ae me et et et et at ah a a a a at tae te it es ns es se ee a ee ee ee es ee Oe ee ms ed Wd cs ee 
eed es Et Bes Chad Bere Cet Crest ct Did Ted ERG Cd Cid Tree Get Gt Ges LO LS et et Se SS Tt a a at A A i it Ct Ct at at Cs a re ee at St Cd Se Od Cd hed ad ed Sd Deed Ceasd Ct Cad Cnet Dad tien id 


ene me me ae en ee ee ee Ct et ae a nt lt at tt at Ot tt eS A at Ct a as ed it He a dO es Os Os Ot eee nese ecenes 


1. Log on the system as the user who is changing the value of 
an environment variable, 


2. Use the ed command to add a line to either the -login or 
-nshrc file (see Appendix C for details). 


3. On the new line, enter the setenv command line in the 
following form: 


setenv VARIABLENAME variablevalue 
The environment variable name MUST be capitalized. 


Using the example from F.3, to change the variable TERM to 
define your terminal as a CIT~16l1 instead of a CIT-1@l: 


Type: setenv TERM citl6l 
Press <RETURN> 


4. Exit ed. You can log off or enter another command. 


SS SS Ot Dl ot ret nt Ct nc i it Ca ed at nt rt at ht Ga a ah Dd Nh ae ee a a dS ss ds ss ee ee Oe Me hs es ee oe es es ee ee ee 
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F.5 DELETING AN ENVIRONMENT VARIABLE 


Follow the instructions below to delete a environment variable 
that is in effect each time you log on. 


tt tt tt tt tt ee eee 
ONO eet et Ces Ped hat St a Tt a at Sd ia Cd at Cc ad Pad Cd Rid Ted tetas Cat SS PS Rt Ot et at a OS al at a et SP lt tC ee at tnt Ce ns Hd She es ns Os ae Ose a an oo eee 


ee a tt he 


1. Log on the system as the user who is deleting an 
environment variable. 


2. At the prompt, enter the command line in the following 
form: 


unsetenv VARIABLENAME 
Capitalize the environment variable name. 


Using the example from F.3 and F.4, to delete the TERM 
variable: 


Type: unsetenv TERM 
Press <RETURN> 


3. When the prompt returns, you can log off or enter another 
command. 


Fe i ee ee, 
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Appendix G 
SOME IMPORTANT FEATURES 
OF THE SHELL 


G.1 INTRODUCTION 


In addition to translating comnands, the shell has several 
features which add to the usability and flexibility of 
REGULUS. This appendix discusses five of those features: 


@ Input/Output (1/0) redirection ~ which sends input 


Or output to a FILE rather than the terminal 
screen 


@ Pipes ~ which redirect COMMANDS so that the output 
of one command becomes the input of another 
command 


@ Wildcards ~ which are useful when searching for 
String patterns 


® Aliases ~ which are abbreviations for COMMANDS 


@ History ~ which is a chronological list of the 
last commands a user has executed 
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G.2 INPUT/OUTPUT REDIRECTION 


To understand input/output (1/0) redirection, you must 
understand the terms: 


® STANDARD INPUT: The default standard input means 
entering information via the terminal keyboard. 


* STANDARD OUTPUT: The default standard output means 
displaying the result on the terminal screen, 


Redirection changes the standard input, or standard output, to 
a FILE which may be a device (i.e., a special file) like a 
printer. 
These symbols are used with redirection: 

° ° (redirect output ~ create or overwrite) 


6 >> (redirect output ~ append) 


® < (redirect input) 


NOTE 


spaces are usually important to REGULUS. However, with the 
above symbols, you can leave spaces before and behind them 
without affecting the meaning of the command line. 


G.2.1 Redirecting Output with > 


The ">" symbol redirects the results of a command to a 
file instead of the screen. The example below CREATES the 


file called outfile and puts the results of the ps into 
outfile, 


ps > outfile 
When you redirect output to a file using ">", REGULUS 


creates the output file, or if a file of that name already 


exists, the file is OVERWRITTEN with the redirected 
results. 
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G.2.2 Redirecting Output with >> 

You can redirect output to an existing file and APPEND to 
the end of the file rather that overwriting the file by 
using ">>". The example below illustrate ">>". 


ps >> appendfile 


G.2.3 Redirecting Input with < 


The "<" symbol redirects input from a file. To illustrate 
redirected input, suppose you have a memo in a file called 
memo.l. You can send (i.e., mail) that memo to another 
user, gerry, uSing redirected input: 


mail gerry < memo,1 
When gerry logs on, he can read your memo by running the 


mail command. (See on~line documentation under mail 
(cmnd) for more information.) 


NOTE 


You can use input and output redirection in one command 
line. In the example below, a file called letters is 


sorted (with the sort command) and then output to a file 
called alphabet: 


sort < letters > alphabet 


G.3 PIPES 


Pipes also redirect input and output. Pipes connect COMMANDS; 
the output of the first command becomes the input of the 
second command. Pipes are indicated by "|" (the symbol either 
above and to the left of the <RETURN> Key or to the right of 
it, depending on your type of terminal). They are often used 
to send a file to the printer. Pipes may be used to connect 
many commands, the output of one becoming the input of the 
next. 


The following example shows how I/O redirection and pipes 


solve the same problem, to sort the contents of a file called 
myfile and send the results of the sort to the printer. 
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Using I/O redirection, we need to create, use, and then remove 
a temporary file called temp: 
1. sort myfile > temp 
2. lpr temp (lpr prints the file) 
3. rm temp (remove the temporary file) 
Using a pipe you can avoid the use of temporary files. The 
pipe below takes the output from the command sort myfile and 
uses the output as input to the lpr (send to printer) command. 
sort myfile | lpr 
Redirection and pipes may be used together. In the following 
example, the file called infile is sorted and used as input 
for the tail command (which displays the last 10 lines of a 
file). The results of the tail command are written to the 
file called outfile: 
sort < infile | tail > outfile 


G.4 WILDCARDS 

The shell has two wildcard symbols: 
@ * (MULTIPLE character wildcard) 
@ °? (SINGLE character wildcard) 


Wildcards are useful when searching for patterns. 


NOTE 


To see exactly what you get when using wildcards, use the echo 
command. See the discussions that follow for echo examples. 
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G.4.1 Wildcarding with * 


The "*" symbol is a multiple character wildcard, often 
used when specifying command arguments. 


Suppose you wish to see all the files in your current 
directory which have the suffix .test. To see these 
files: 

Type: echo *.test 

Press <RETURN> 
Then, Suppose you wish to delete all those files: 

Type: rm *.test 

Press <RETURN> 
You can use more than one "*" in one command line. For 
example, to see all the files in your current directory 
with lp somewhere in their names: 


Type: echo *lp* 


Press <RETURN> 


G.4.2 Wildcarding with ? 


the "?" 1s a single character wildcard. Use it like "*", 
except that it replaces a single character. 


Suppose you have files in your current directory whose 
names begin with test. followed by a single character. To 
see these files: 


Type: echo test.? 
Press <RETURN> 

Then, suppose you wish to delete all those files: 
Type: rm test.? 


Press <RETURN> 
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ae 
G.5 ALIASES 
This feature lets you create and use abbreviations for 
COMMANDS. Aliases are often used to reduce the number of 


keystrokes required to enter often used or long commands. You 
can also use abbreviations that may be easier to remember than 


REGULUS commands. 
Aliases are active only while the current shell is active. To 
make them active for each login shell, aliases can be entries 
in a user's .login or .nshrc file (see Section 3). Enter 
aliases as follows: 

alias userabbreviation "command being replaced" 


The following are some useful alias examples: 


alias a "alias" 


ao "logout" 


ah “history" 


ap "Ds -~e)]" 


all "lg -]" 


See the on-line documentation under sh (cmnd) for more on 
aliases, 


G.6 HISTORY 


The shell automatically keeps a chronological, numbered list 
of the last 20 (this is a default value that you can change) 
commands each user has executed since logging on. This list 
1s called the history event list or history. To display a 
user's history: 


Type: history 
Press <RETURN> 


Figure G~l is an example of a history event list. 
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Cd acct 

dir 

ls -1l jan.rec 

chown gerry jan.rec 
ed jan.rec 

cd 


dir 

Cat test.1 

lex 

cat filsys.doc 
ps —-el 


WON AUS WH 


Cat hardw.doc 

cat ipl.doc 

Cat intro.doc 

rm filsys.* hardw.* intro. * 
Ipq 

cat gerry.let2 

dir 

rm whatsup 

history 


Figure G~l. Example of a History List. 


The shell lets you reexecute commands listed in your history 
file. It also lets you edit and modify a history entry and 
then reexecute it. 


The symbol "!" is used to reexecute a command listed in the 
history event list. The following examples refer to Figure 
G~l. 


Meaning 


Reexecute the command listed 
in line 16. 


Reexecute the last command 
that began with c». i.e... line 
i7. 


CIE SYSTEMS REGULUS G~7 SYSTEM ADMINISTRATOR'S MANUAL 


Appendix G, Some Important Features of the Shell 


Using REGULUS' line editor (see Appendix C), "@" lets you edit 
a command listed in history. (Details for using "@" are given 
in the on-line documentation under sh (amnd).) The following 
examples refer to Figure G~l. 


Meaning 


Fdit the command listed in 
line 8. 


Edit the last command in the 
history file that begins with 
C » 1.@.» line 17. 


For more detailed information about history, see the on~line 
documentation under sh (cmnd). 
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THE SELF BOOT DISKETTE 


H.1 INTRODUCTION 


The Self Boot Diskette (SBD) is one of the most important 
tools the REGULUS system administrator has. 


This appendix includes: 
& Uses of the SBD 
@ Contents of the SBD 


® The on~line documentation for the SBD 


H.2 USES OF THE SELF BOOT DISKETTE 
Using the SBD you can: 


@® Initialize and update REGULUS ~~ It loads the 
Kernel set of diskettes. 


6 Operate the SBD as a stand~alone REGULUS file 
System -~ It 1s bootable by entering "“f" to the 
boot prompt. 


@ Diagnose and repair damage on the root file system 


on your hard disk ~~ See the on~line documentation 
in H.3 for details. 
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@ Use any of the commands on the SBD under /etc and 
/f/oin (see H.3) 


@ Access any commands in the mounted root file 
System on your hard disk by using their full path 
names -~ Instructions for mounting your hard disk 
are given in the on-line documentation in H.3. 


Since the ed (editor) program is NOT on the SBD, 
you must access using the path name /mnt/bin/ed. 
For example, to edit the /etc/passwd file, enter: 


/mnt/bin/ed /etc/passwd 


H.2 CONTENTS OF THE SELF BOOT DISKETTE 


The contents of each of the directories on the SBD are given 
below. Note that /mnt and /tmp are empty. 


Directory / 


[bin] [mnt ] fboot regulus 
[dev] [tmp] initrg 
[etc] aboot nboot 


Directory /dev 


(*) atasi@ (*) 1p (*) rflp@ (*) rsmdg@ 
(*) console (*) npl@ (*) rnpl@ (*) smd@ 
(*) f1p@d (*) ratasi@ (*) rootfs (*) tty 
Directory /bin 

{cp} {mkdir} {sh} 

{ddt } {rm} {tar} 

Directory /etc 

passwd {format } {fsdb} {mount} 
ttys { £sck } {mkfs } {sysgen} 


Directory /mnt 


Directory /tmp 


H.3 THE ON~LINE DOCUMENTATION FOR THE SELF BOOT DISKETTE 


A copy on the on~line document for the self boot diskette 
(usr) follows. 
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SELFBOOT DISKETTE SELFBOOT DISKETTE 


NAME 
selfboot - REGULUS selfboot diskette 


FUNCTION 
When the Self Boot Diskette (SBD) is booted, it displays the 
following menu: 


saan eiaatieateteatetetonton SELFBOOT DISKETTE MENU ---------~ 
Le Initialize new system. 
2. Update current system. 
3. Check hard disk file system. 
4. Copy bootblock to hard disk. 
S- Build hard disk device nodes. 
6. Rebuild hard disk blocks. 
7. Exit to shell. 


Options (1) and (2) are used during system initialization and 
update. when a new release of the REGULUS operating system is 
installed. Options (3) through (6) are used to diagnose and 
correct problems encountered with the hard disk. Option (7) 
terminates the menu options and gives control to the shell. 


The procedure for system installation is self documenting and is 
not covered here. 


As With the main system disk, the SBD must not be write~protected 
(im order to allow file system updates) and therefore is 
vulnerable. The SBD master is Supplied write-protected and 
therefore a nonwrite-protected copy must be made (using the 
Single Floppy Copy program on the Stand Alone Utility Diskette) 
Which will then be used. 


As with any hard disk.» the SBD file system can become corrupted 
and can be repaired by using the ’fsck’ program. However, if the 
problems are severe a new copy should be made from the master. 
Since the SBD file System is only 64@ blocks, Swapping is not 
allowed. Therefore, on systems with small memory (e.g. 256K), it 
may happen that there ig not enough room for both the shell and 
the program being executed. Should this occur, use the ‘exec’ 
shell command when running programs: 


exec program 


where ’program’ is any command found in /bin or /etc. 


REGULUS Reference Manual MAINT 


CIE SYSTEMS REGULUS H~3 SYSTEM ADMINISTRATOR'S MANUAL 


Appendix H, The Self Boot Diskette 


SELFBOOT DISKETTE SELFBOOT DISKETTE 
SELFBOOT DIAGNOSTIC FEATURES 


The remainder of this document deals With the use of the SBD as a 
diagnostic and corrective tool to be used when the hard disk will 


not boot. If the cause of the hard disk Problems has not been 
determined, the menu options should be executed in the following 
order. 


OPTION (3): 

This option should be usd as the first attempt to correct 
the problem. If errors are detected they should be 
corrected by answering ’y’ to the prompt "Attempt to fix?"., 
If the file system problems cannot be corrected with this 
procedure» exit the menu with Option (7) and perform the 
feck manually. See help fsck (usr) and fgsek (maint) for 
instructions. 


It may be that some files critical to booting are missing on 
the hard disk. Option (3) will report such missing files. 
These files can be restored by performing option (2) to 
UPDATE the hard disk. 


OPTION (4): 


[If the fsck is clean, and the System still will not boot, 
try option (4) to restore the hard disk boot block. 


OPTION (5): 
If there are still Problems» use option (5) to rebuild the 
hard disk device nodes. Some of these nodes are critical to 
the boot procedure. 


All the above procedures are relatively safe and can be used 
to repair simple hard disk problems. 


OPTION (6): 

If 1/0 errors occur when attempting to read the first fey 
blocks of the hard disk (1.e. blocks @® through 2), these 
blocks can be rebuilt using option (6). This option is 
potentially very dangerous and should ONLY be used if there 
18 a need to rebuild the Superblock or the root index block 
On the hard disk. The user must have a knowledge of REGULUS 
file system structure to perform this option. 


The user will be prompted to enter the number of blocks to 
rebuild. The blocks will be copied directly from the SBD to 
the hard disk. The correct boot block will be restored, and 
the hard disk file System size reset. 


After completion of Option (6). option (3) must be performed 
to check the hard disk file system. 


OPTION (7): 
The final option will place the user in the REGULUS shell at 


which point all the normal shell functions become 
Operational. To return to the SBD menu, type: 
REGULUS Reference Manual MAINT 
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SELFBOOT DISKETTE SELFBOOT DISKETTE 


exec /etc/sysgen 


*’sysgen’ 1s the program which performs all the menu 
functions. 


The SBD has a directory tree structure identical to the 
major aspects of the root file system and has most of the 
primary REGULUS maintenance utilities. To list all the SBD 
avallable programs at the *COMMAND?’ prompt type: 


echo /bin/* 
echo /etc/* 


These utilities are documented in the REGULUS manual. 


The following hard disk device names are used by the SBD: 


/dev/npl@ = 10 MB NPL WINCHESTER 
/dev/atasi®@ = 46 MB ATASI WINCHESTER 
/dev/smd@ = 84 MB FUJITSU SMD 


Any hard disk can be mounted and accessed through the SBD. 
For example: 


mount /dev/atas1@ /mnt 


Now all the programs on the hard disk may be executed as if 
they were on the SBD. 


NOTE: there 1s no ’unmount’ command on the SBD. When 
finished using the mounted hard disk type ’sync’ and IPL. 
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{!, G~-7. SEE ALSO shell history 
lr G~3 ~ G~4. SEE ALSO pipes and shell 
, G~4 ~ G4. SEE ALSO wildcards and shell 
, 3~9, 3~-ll. SEE ALSO directories root 
, G-2 ~ G-3. SEE ALSO input/output redirection and shell 
>, G2. SEE ALSO input/output redirection and shell - 
>>, G-2 - G3. SEE ALSO input/output redirection and shell 
2, G-4 ~- G5. SEE ALSO wildcards and shell 
@, G~8. SEE ALSO shell history 
680/20, 2-4, 7-7. SEE ALSO CIE 68@ systems 
680/38-18, 2-4, 7-7. SEE ALSO CIE 68@ systems 
680/30-46, 2-4, 7~7. SEE ALSO CIE 68@ systems 
686/35, 2-4, 7-7, 7-56. SEE ALSO CIE 680 systems 
680/40, 2-4, 7-7, 7-56. SEE ALSO CIE 688 systems 
680/100, 2-4, 7-7. SEE ALSO CIE 688 systems 
680/200, 2-4, 7-7, 7-56. SEE ALSO CIE 680 systems 
additional software, 4-1] 
adduser. SEE commands 
aliases. SEE shell 
alternate tracks, 7~56. SEE ALSO smdalts 
application software, 3-2, 3~33. SEE ALSO software 
asynchronous communication controller, 2~8, 7~35. SEE ALSO 
controllers 
background processes. SEE processes 
backup, 4~10, 4~16, 5-5 ~ 5-15. SEE ALSO restore and shutdown 
procedure 
rotation, 5~8 - 5-9 
entire, 5-8 - 5-9, 5-14 
partial 5-8 - 5-9, 5-14 
bad block, 7-2 
baud rate, 7-39 ~ 7~4@ 
/bin. SEE directories 
/bin/sh. SEE programs 
binder. SEE REGULUS System Administrator's Binder 
block special files. SEE files 
blocks, 3-6, 3~8, 7~46. SEE ALSO file system 
boot device, 7-7, 7~9. SEE ALSO processes 
booting. SEE processes 
BSP, 3-3, 7-2 
buffer, C~5. SEE ALSO memory 
Business Solutions Package. SEE BSP 
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capstan, 6-2, 6-4, 6-6. SEE ALSO heads 
cartridge tapes, 4-10, 4-16, 5-5, 5-7, 6~7 
Capacity, 5-7 
cat. SEE commands 
CDC controller, 2~8. SEE ALSO controllers 
Central Processing Unit (CPU). SEE CPU 
character special files. SEE files 
chmod. SEE commands 
chown. SEE commands 
CIES 688 systems, 2-1, 2-2, 2-3, 2-4, 2-5, 5~5 
cleaning kits, 6-4 
cmnd. SEE on~line documentation 
CNIX utilities, 3-3 
commands, 3-5, 3-16, 3-34 ~ 3~35, D-l, G~l, G-3 ~ G-4, G-6 ~ 
G~8 
adduser (add a user), 7-9 ~ 7-ll, E~l 
cat (display file), 7-26 
cd (change directory), 3~ll, 6-12 
chmod (change mode), 7~28 
chown (change ownership), 7~29 - 7~3@ 
config, 7~26, 7~32 ~ 7~33 
configure, 7~25 
Cp (copy) , 4-14 
df (disk free space), 5ll, 7-48 
dir (display directory), 3~9, 3~ll - 3-12, 3-13, 3-16, 
3~42 
dspuser (display users), 7~ll, E~2 
ed (editor), 7~48, 7-58, C~l, C-5 ~ C~14, E-l 
env (environment), F~2 
fsck (file system check), 5-2, 5-ll, 7-48 
fsck ~-s, 3-30 
head, 7~21 ~ 7-22 
help, 1-5, 3-3, D-l, D~2, D-4, D~6 
kill (terminate task), 3~28, 7~30 ~- 7~32 
kill -9, 7-32 
link, 3-13 
list -p, 4-14 
In, 3-13. SEE ALSO link 
load, 5-17, 5-20, 6~17 
load~ct, 5-17, 5~20, 6-17 
look, 5-19 
look~ct, 5-19 
lpconfig, 3~38, 7~34 ~ 7-41 
lpconfig -d, 7~38 
lpconfig -p, 7~36 
lpconfig ~s, 7~4@ 
lpd (line printer daemon), 7-24 
lpd restart, 7-25 
lpq (line printer queve), 7-21 ~- 7~22 
lpr -k, 7-23 ~ 7-24 
lpr, 7-23 - 7~24, 7~34 ~ 7~35 
Iprm (line printer daemon remove), 7-22 ~ 7-23 
ls ~-lt, 6-9 
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commands, continued: 
ls ~-1, 3-15, 3~16, 7~26, 7-29 
makemanual, 1-6, D-l, D-/7 ~ D-8, D~1@ 
Makeperm, D-4 ~ D-5 
man (manual), D~l, D-6 ~ D-7 
mkdir (make directory), 7-54 
mkfs (make file system), 7~47 
mount, 7~-58 ~ 7-52 
mount all, 7~-52 
mv (move), 6-18 
passwd (password), 7-14 ~ 7-18, E-3 
ps (process status), 3-34 
ps ~el, 7-28, 7~38 - 7-31 
pwd (display present working directory), 3~1l 
rm (remove), 3-13, 6-10 
save, 5-6, 6-18, 6-11, 6-13, 6-15 
save~ct, 6-ll, 6-13, 6-15 
setenv (set environment), 3~33, F-2 ~ F~4 
shutdown, 7-6 
smdalts, 7-56 
sync (synchronize), 3-27, 3-30 
umount, 7~53 ~— 7=55 
umount all, 7-54 
unsetenv, F-2, F~-6 
upduser (update user), 7-ll, E~-l 
wait, 3-29 
command interpreter. SEE shell 
components. SEE hardware 
computer, l-l, 2~5, 3-1, 3-2. SEE ALSO CIES 688 systems 
config. SEE commands 
configuration. SEE system configuration 
console, 2-5, 2-8, 3-38. SEE ALSO terminals 
controllers, 2~7 ~ 2~9. SEE ALSO individual controllers: 
asynchronous communication, CDC, DMA, DSD, magnetic tape 
drive 
cp. SEE commands 
CPU, 2-2, 2-7, 2-9 
Current working directory. SEE directory 
cylinders. SEE hard disk 
default mode. SEE ALSO mode and permissions 
directories, 7-27 
nonexecutable files, 7~—27 
defunct processes. SEE processes 
descriptive information ratings, 1-5 
dev. SEE on-line documentation 
/aev. SEE directories 
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device, 7-52 
name, 7~46, 7-53 
fmtflp, 7-46 
fmtfuj, 7-46 
fmtwin, 7~46 
numbers, 7~43, 7~45, 7~47 
/dev/flpx, 7-47 
/dev/smdxX, 7~47 
/dev/winxX, 7-47 
major, 7-41, 7-42 
minor, 7-41 
Gf. SEE conmands 
diagnostic programs, 4-18, 7-6. SEE ALSO Stand~Alone 
Diagnostic Diskette 
dir. SEE commands 
directories, 3-6, 3-9, 3-11, 3-13 ~ 3-14, 3-15, 3~17, 3~42, 
6-9, 
/ (root), 3~6, 3-7 ~ 3-9, 3-13, 3-19, 4-15 
Current working, E~6. SEE ALSO directory present working 
home, 3-20 ~ 3-22, 3~33, 3-48, 3-41, 7-9, E-6 
name, 3~12. SEE ALSO path names 
present working, 3-11 ~ 3~12, 3-15, 3-20, 3~22 
REGULUS directories and subdirectories, 3-7 ~ 3-8, D-l 
/bin, 3~8, 4-15 
/dev, 3~8, 3-17, 4-15, 7-27, 7~42 - 7-43, 7-49 ~ 751 
/Goc/man, 3-8, 4-15, D~1l 
/etc, 3-8, 3~35 ~ 3-42, 4-15 


/lib, 3~8, 4~15 
fant, 3-8, 4-15, 7-51, 7~54 
/tmp, 3~8, 4-15 


/usr, 3—-8, 4-15 
/usr/install, 3-8, 7-5 
/asr/spool/lpr, 3~8, 7-19 ~ 7-26 
-dirname. SEE files 
diskette, 2-6, 4-10, 4-11, 4-16 ~ 4-17, 6-7, 6-ll ~ 6-13, 
7~6, 7-45, 7-52 
capacity, 5-6 ~ 5-7 
diskette drive, 2-6, 2-8, 3-17, 6-2 
disks. SEE hard disks 
DMA controller, 2~8 ~ 2-9, 7~37. SEE ALSO controllers 
/doc/man. SEE directories 
documentation. SEE on-line documentation 
DSD controller, 2~8 ~- 2-9. SEE ALSO controllers 
dspuser. SEE commands 
ed commands and usage, C~l, C-5 ~ C-14. SEE ALSO commands 
ed prompt, C-5, C-9 
entire backup. SEE backup 
entire restore. SEE restore 
env. SEE commands 
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environment, 3-27, 3-33, F-l ~ F-5 
env. SEE commands 
setenv. SEE commands 
unsetenv. SEE commands 
variables, 3~33, 3~40, F-l ~ F~4 
default, 3~33, F-l ~ F-2 
f/etc. SEE directories 
/etc/disks. SEE files 
/etc/dtab. SEE files 
/ tc/group. SEE files 
/etc/motd. SEE files 
/etc/mountfiles. SEE files 
/etc/mtab. SEE files 
/etc/passwd. SEE files 
/etc/rce. SEE files 
/etc/sitename. SEE files 
/etc/spstty. SEE files 
/etc/ttys. SEE files 
/etc/update. SEE files. 
/etc/utmp. SEE files 
executable task memory. SEE memory 
file check, 5~ll. SEE ALSO fsck 
file system, 3-6 ~ 3-18, 4-16, 7-49 ~ 7~52 
creating, 7~44 ~ 7~47 
mounted, 5-ll, 6-18 
mounting, 3-48, 7~48 ~ 7-53 
root, /~-43, 7-55, H~l 
tree-Structure, 3-6 ~ 3-9, 3-22 
unmounting, 7-54 ~ 7-55 
files. SEE on-line documentation 
files, 3-6 ~- 3-7, 3-ll ~ 3-12, 3~35 ~ 3-42 
access, 3-260 
mode. SEE mode 
name. SEE path name 
ownership, 3~23, 7~29 ~ 7~3@ 
spooled, 7~23, 7~25 
SsyStem administrator files, 3~35 ~ 3-42 
/etc/disks, 3-37 
/etc/dtab, 3~37 
/etc/group, 3-39, 7~12 ~ 7-14, 7~17 - 7-18 
/etc/motd, 3~39 
/etc/mountfiles, 3-40, 5~ll, 7-48 ~ 7-49, 7-52, 
7-54 
/etc/mtab, 3-39 
/etc/passwd, 3-21 ~ 3-22, 3-36, 3-39, 4-12, 4-13 - 
4-14, 7-14 ~ 7-18, E~-l ~- E-6 
/etc/rc, 3-29, 3~36, 3-38, 5-2 - 5-5, 7-48, 7-50 
/etc/sitename, 3~39 
/etc/spstty, 3-38 
/Jetc/ttys, 3-37 
/etc/update, 3~26 ~ 3-27, 3-29, 3-30 
/etc/utmp, 3-38 
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files, continued: 
types, 3-15 ~ 3-18 
directory, 3-17 
executable, 3-16, 7-27 
plain, 3-16, 7~27 
special block, 3-17, 7-27 
special character, 3~17, 7-27 
user files, 3-40 ~ 3-42 
-dirname, 3~42 
-login, 3-40 ~- 3~41, F~4, G-6 
~logout, 3-48 ~- 3-41 
-nshrc, 3-33, 3-40, 3-42, F-4, G-6 
write~permission, 3-17. SEE ALSO mode 
foreground processes. SEE processes 
formatting 
floppy disk (diskette), 4-11 
hard disk, 7~44 ~ 7~46 
fsck. SEE commands 
fsck ~s. SEE commands 
groups, 3-206 ~ 3-22, 3~23, 7-10, 7-14, E-6 
ID (GID), 3-21, 3-22, E-l, E-6 
name, 7-14 
password, 7~14, 7-17 ~ 7-18 
hard disks, 2-5 ~ 2-6, 2-8, 3-26 ~ 3-27, 3~38, 3-37, 4-19, 
7-3, 7-6, 7~43, 7-46. SEE ALSO /etc/disks 
cylinders, 2-6, 7-2 ~ 7~3 
drives, 2-3, 2-5 - 2-6, 3-17 
Winchester, 2~5 
heads, 2~6, 7-2 ~ 7-3 
platters, 2-6 
sectors, 2-6 
tracks, 2-6 
hardware, 2~1 - 2-9, 3-2, 4-2, 4-18, 6-2 ~ 6-6 
heads. SEE hard disks 
help. SEE commands and on-line documentation 
history, G~6 ~ G~8. SEE ALSO shell 
home directories. SEE directories 
Initial Program Load. SEE IPL 
Initialize REGULUS, 3-13, 3-19, 4-ll, 7~2 ~ 7-3, 7-32, 7-34, 
7-42, 7-56, E~6, H-l. SEE ALSO update REGULUS 
input/output (1/0), 3-17, 7-56, G-l ~ G-4. SEE ALSO processes 
and shell 
redirection, G~2 ~ G-~3, G~4. SEE ALSO shell 
install REGULUS. SEE initialize and update 
install user, 3-19, 3-20, 3~21, 7-4 ~ 7-5, D-4, E-5. SEE ALSO 
user accounts 
Installation Manual, 4-2 
installation card, 4-1l, 7-2 
installation history file, 7~5. SEE ALSO SIP 
installing additional software, 4-11, 7-4 - 7-5 
instruction card. SEE installation card 
I/O. SEE input/output 
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IPL (Initial Program Load), 3-26, 3~31 ~ 3~32, 5-2 ~ 5~4, 
9~5, 5-9, 5-12, 7-6 ~ 7-9 , 
errors, 7-9 . 

Kernel. SEE REGULUS Kernel 

keyboard, 2-5 

keyword. SEE on-line documentation 

/lib. SEE directories 

line editor, C~-l, C~2 ~ C-~4, C-8, C-14 

link. SEE commands 

linking, 3~12 ~ 3-13 

In. SEE commands 

load. SEE commands 

load~ct. SEE commands 

-login. SEE files 

logging off, 4-11, 4-13 

logging on, 4~1l, 4-12 

-logout. SEE files 

look. SEE commands 

look~-ct. SEE commands 

lpconfig. SEE commands 

lpd. SEE commands 

lpq. SEE commands 

lpr ~k. SEE commands 

ls. SEE commands 

ls ~lt. SEE commands 

maint. SEE on-line documentation 

maint user, 3-19, 3~28, 3~21, 3-30, 5-21 ~ 5~22, E-5. SEE 
ALSO user accounts 

Maintenance functions, 3~5, 3-16, 3-19, 3~30 

major numbers. SEE device numbers 

makemanual. SEE commands 

makeperm., SEE commands 

man. SEE commands 

manual syntax, 1-3 

Media Defect List, 7~2 ~ 7~3, 7-44 

Medical Solutions Package. SEE MSP 

memory, 2~6, 3~24 ~ 3-27, 3~32, 7-6 
executable task, 3-24, 3~26 
operating system, 3-24, 3-26 
tests, 3~32, 5-4, 7-9 
"wasted" space, 3-24, 3~26 

memory modules, 2~2. SEE ALSO hardware 

message~of~the—-day. SEE /etc/motd 

minor numbers. SEE device numbers 

misc. SEE on-line documentation 

/mnt. SEE directories 

mode, 3~23, 3-27, 7-26 ~ 7~28. SEE ALSO permissions and 
default modes 

modems, 2~8. SEE ALSO hardware 

mount all. SEE commands 

mounting file systems. SEE file systems 

MSP, 3-3, 3-5 

multi-user mode, 3~38, 5-2. SEE ALSO Single~user mode 
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mv. SEE commands 
new shell run command. SEE .nshrc 
-nshrc. SEE files 
on-line documentation, 1-5, 3~3, 7~2, D~l - D-1@ 
categories, D-l ~- D~2 
cmnd, D-2 
dev, D~2 
files, D-2 
maint, D~2 
misc, D~2 
usr, D~2 
help. SEE commands 
keyword, D~3 
makemanual. SEE commands 
makeperm. SEE commands 
man. SEE commands 
topics, D-l, D-3 
uSing, 1~5, D-l - D-1@ 
OPENFIRST documents, 4~2, 4~ll, 7-2 
operating system, 3-2, 3-5, 3~26, 7-6. SEE ALSO REGULUS and 
software 
Operator's Guide, 4-3, 5-6 
parallel port, 7~36 
parent process ID (PPID), 3-27. SEE ALSO processes 
partial backup. SEE backup 
partial restore. SEE restore 
passwd. SEE commands 
password, 3~21 ~ 3-22, 4-13 ~ 4-14, 7-14 ~ 7-18, E-2 - E-6 
path names, 3~9 ~ 3-12, 7-20 
peripherals, 2~3 ~ 2-7. SEE ALSO hardware 
permissions, 3-18, 3-23, 7~26 ~ 7~28. SEE ALSO mode 
bits, 7~26 ~ 7~27 
execute (x), 3-23, 7-26 ~ 7~27 
read (r), 3-23, 7-26 ~ 7~27 
write (w), 3~-23, 7-26 ~ 7-27 
pipes, G~3 ~ G~4. SEE ALSO shell 
platters. SEE hard disk 
power down, 7-9 
power supply, 2-9 
present working directory. SEE directories 
print queue, 7~28 ~ 7-21. SEE ALSO /usr/spool/lpr and spooler 
printers, 2-7, 3~17 
adding, 7~34 ~ 7~43 
cleaning, 6~2, 6-6 
DMA, 7~37 ~ 7-39 
names, /~34 
parallel, 7~35 - 7~37 
serial, 7-39 ~ 7-4] 
Process ID (PID), 3-27, 7-29. SEE ALSO processes 
process table, 3~28, 3~29, 7~3 ~ 7~3l1. SEE ALSO ps ~el 
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processes, 3-27 ~ 3-32. SEE ALSO input/output, parent 
process IDs (PPID), process IDs (PID), IPL, single-user 
mode, multi~user mode 
background, 3-29 
booting, 3~32, 7~6, 7-9. SEE ALSO IPL 
defunct, 3--29 
foreground, 3~29 
resetting, 3~31, 7-6. SEE ALSO IPL 
programs, REGULUS. SEE ALSO files 
/bin/login, 3-33, 3~36 
/odin/sh, 3-5, 3~22, 7-9, 7-10, E~6. SEE ALSO shell 
protection features, 3~21. SEE ALSO groups and passwords 
ps -el. SEE commands 
ps. SEE commands 
ratings. SEE descriptive information ratings 
redirection. SEE input/output 
regular user accounts, 3-28. SEE ALSO user accounts 
REGULUS, 3~1 ~ 3-6. SEE individual entries 
REGULUS commands. SEE commands 
REGULUS directories and subdirectories. SEE directories 
REGULUS diskettes, 3~3 ~ 3-5. SEE ALSO Self Boot Diskette 
REGULUS file system. SEE file system 
REGULUS files. SEE files 
REGULUS Kernel, 3~2 - 3-5, 4-ll, 7~2 
REGULUS on-line documentation. SEE on-line documentation 
REGULUS operating system, 3~2, 3-4, C-l 
REGULUS programs. SEE programs 
REGULUS Quick Reference Command Summary, 1-6 
REGULUS Reference Manual, 1-6, D-l, D-7 - D-1@ 
REGULUS software, 1~1, 4-180, 5~2. SEE ALSO REGULUS Kernel and 
REGULUS diskettes 
REGULUS System Administrator's Binder, 1 
REGULUS System Administrator's Manual, 1 
REGULUS Utilities, 3-3, 3-5, 7~2 
Release Notes, 4-2 
resetting. SEE processes 
restore, 4-17, 5-16 - 5~21. SEE ALSO backup 
mm. SEE commands 
root (/) directory. SEE directories 
root file system. SEE file system 
root user, 3-18 ~ 3-19, 3~23 ~ 3~24, 3~36, 7-9, 7-16, 7-17 - 
7-18, 7-25, 7-28, 7-38, 7-51, 7-52, 7~53, 7-54, 7-56, E~3 
E~5, E~6. SEE ALSO user accounts and superuser 
Save. SEE commands 
secret password, 3-19, 3~22. SEE ALSO passwords 
sectors. SEE hard disk 
Self Boot Diskette, 3~3, 7-3, E~3, H~l ~ H-5 
serial ports, 7~33, 7-39. SEE ALSO terminal ports 
setenv. SEE commands 
sh. SEE programs and shell 


~4, 4-2 
~l, 1-4 


a 


CIE SYSTEMS REGULUS I~9 SYSTEM ADMINISTRATOR'S MANUAL 


Appendix I, Index 


shell, 3~5, 3-22, E~6, G~-l ~ G-8 
aliases, 3-49, G-6 
command interpreter, 3-5, 3~34 ~ 3+35 
features, G~-l ~- G8 
history, C~l, G-6 ~ G-8 
scripts, 3-16, 3~34 
wildcards, G-l, G~4 
shut down, 5-5 ~ 5-15 
shutdown. SEE commands 
Shutdown Status Sheets, 1~4, 4-2, 5-2, 5-7, 5-10, 5-14, 5~22, 
6-2, 6-5, 6-7 ~ 6-8, 6-9 
shutdown user, 3-20, 3- 21, 3-30, 3~31, 4-12, 4-16, 5-5, 5-12, 
7-6, E~5. SEE ALSO user accounts 
procedure, 9-9 ~ 5-ll, 7-49 
backup, 5~12 ~ 5-15 
restore, 5-16 ~ 5-21 
Single-user mode, 3-38, 5-9, 5-12, 5-16. SEE ALSO multi-user 
mode 
SIP, 7~4 ~ 7-5 
history file, 7-5 
SMD controller, 2~9. SEE ALSO controllers 
smdalts. SEE commands 
software. SEE operating system, REGULUS, application software 
Software Installation Procedure. SEE SIP 
Special function users, 3~19 ~ 3-208. SEE ALSO user accounts 
spooler, 7-19 ~ 7~26. SEE ALSO /usr/spool/lpr and print queue 
Stand-Alone Diagnostic Diskette, 4~16 
Stand-Alone Diagnostic Instruction Guide, 4~2 
Stand-Alone Exerciser Diskette, 4-10, 4-16 
Stand~Alone Exerciser Instruction Guide, 4-2, 4-14 
Stand-Alone Utility Diskette, 4-11, 4-16 
Stand-Alone Utility Instruction Guide, 4-2, 5~6 
Standard input. SEE input/output 
Standard output. SEE input/output 
Start up procedure, 5-2 ~ 5-5, 5-21 
storage devices 
permanent, 2-5 ~ 2-7, 4-19 
temporary, 2-3 
Streamer tape drives, 2~3, 2~7, 2-8, 3-17, 6-2, 6-4 
hardware 
streamer tapes. SEE cartridge tapes 
Subdirectories, 3~6 ~ 3-7, 3-9, 3-ll, 3- 13, 3~16, 4-15, 6-12. 
SEE ALSO directories 
Superuser, 3-22, E~5. SEE ALSO root user 
Swap space, 2-6, 3-26. SEE ALSO memory 
Swapping, 3~26 ~ 3~27 
Sync. SEE commands 
Syntax. SEE manual syntax 
system administrator files. SEE files 
system administrator, 1~l, 2-1, 3~1, 3-7, 3-19 ~ 3-29, 3—21, 
3-22, 3-38, 3-31, 3- 35, 3-36, eA, 5-2, 6-1, 6-2, 7-6, 
7-9, 7-14, 7-19 


ei tee, SEE files system administrator 


- SEE ALSO 
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system backup. SEE backup 
system cabinets, 2~9 
system configuration, 2-1, 2-5, 2-7, 2~9, 3~26 
system console. SEE console 
system enclosures, 2-9 
system modules, 2~1 ~ 2-2 
tapes. SEE cartridge tapes 
terminals, 2-5, 2-8, 3-17, 3-30, 3-37, 3-38, 7~3, C-l 
adding, 7-32 ~ 7~33 
modes, 4-3 
CIT~101, 4-3 
CIT-161, 4~3 
CIT~500, 4-7 - 4-9 
CIT~80z, 4-6 
ports, 7-33, 7-39. SEE ALSO serial ports 
types, 3-33. SEE ALSO terminal modes 
/tmp. SEE directories 
topics. SEE on-line documentation 
tracks. SEE hard disk 
tree-structured file system. SEE file system 
tty (terminal), 7-31. SEE ALSO terminals 
umount. SEE commands 
umount all. SEE commands 
UNIX, 3-1, 3-3 
unmount. SEE file system unmounting 
unsetenv. SEE commands 
update REGULUS, 7~2 ~ 7-4, 7-32, 7-42, 7-56 H-l. SEE ALSO 
initialize 
upduser. SEE command 
usage rights. SEE permissions and mode 
usr. SEE on-line documentation 
/usr. SEE directories 
/usr/install. SEE directories 
/usr/spool/lpr. SEE directories 
user 
accounts, 3-18 ~- 3~22, E~l 
regular users, 3-280 - 3-22 
special function users: install, maint, root, 
shutdown. SEE those entries (ex. install user) 
adding, 7~9 ~7~ll 
directories. SEE directories home 
files, 3-40 ~- 3-42. SEE ALSO files 
groups. SEE groups 
ID (UID), 3-22, 3-27, 5-18, 5~21, 7~9, 7~ll, E-5 
name, 3~22, 4-12, 7-28, E-2 
password. SEE passwords 
utilities. SEE REGULUS Utilities 
video display unit (VDU), 2-5 
walt. SEE commands 
wasted memory area. SEE memory 
wildcards. SEE shell 
Winchester. SEE hard disk drives 
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POWERING THE SYSTEM 
1. CPU enclosure does not come on when power switch is depressed. 


a. Power cord is not connected to appropriate power source. 
Check to ensure that the correct voltage is present. This can 
be accomplished by connecting a known working device to the 
power source such as a lamp. 


b. Cabinet A/C power strip fuse blown. Replace with a fuse of 
same type. If a higher rated fuse is used, serious damage 
will result. 


c. System has malfunctioned. Call Customer Service. 


2. Peripheral enclosure does not come on when power switch is 
depressed. 


a. Incorrect or faulty power source, see above. 


b. Internal D.C. power cables may have been dislodged. These 
cables must be connected observing correct polarity. To avoid 
possible damage call customer service for assistance. Normally 
this problem is noticed when the peripheral enclosure fan is 
functioning, but the disk drive is not. 


c. In some units there is a D.C. power supply fuse, however this 


fuse is not user servicable and must be replaced by a 
qualified technician. 
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TERMINAL 


This section deals with four different terminals, the CIT-89, CIT-191, 
CIT-161, and the CIT-5@0. Although the terminals are similar in 
design, the terminology used to describe various functions differs. 
For instance, the CIT-89 and 500 refer to their setup areas as fields, 
but the CIT-191 and 161 refer to theirs as groups. The following setup 
recommendations try to maintain consistancy with the appropriate 
Operator manual and should be used as an enhancement, not a 
substitute. 


Incorrect terminal setup choices can cause the data to be displayed 
improperly or not at all. Some of the most common are: 


1. Terminal screen is blank. 
a. Intensity is turned down. 


The methods of increasing the intensity differ with the 
type of terminal. In the case of the CIT-8@ and 161, an 
intensity adjustment can be found at the right rear of the 
unit. The CIT-101 and 5080 intensity is changed by using 
the up and down arrows while in setup mode. 


b. CRT saver is activated. 


The CRT saver is a selectable option which turns the video 
display off when there is no terminal activity. 
Reactivation takes place by depressing any keyboard key. 
CRT saver selection is available on the CIT-101, 161, and 
5908 terminals in setup mode C. On the CIT-101 and 161 the 
option can be found at group 4, position 1. The CIT-5ad 
locates this-option in field C, position 3. For further 
assistance please reference the operator's manual for the 
respective terminal. 


2. Information being displayed is nonsense and/or unreadable. 
a. Baud rate not set to 9600 baud. 


The default terminal speed for any CIE system port is 9600 
baud. Therefore the terminal must also be set up for 9600 
baud. Baud is a data communications term meaning bits per 
second. This terminal option on the CIT-8@ is called main 
port speed. The CIT-89 offers only one setup mode, with 
main port speed selection as the first option. Using the 
6” key while in setup mode, select 9600 in the reverse 
video window being displayed. In the case of the CIT-101 
and 161 terminals the speed is displayed as T SPEED and R 
SPEED in the lower right corner while in setup mode B. 
With T and R representing transmit and receive these two 
speeds must be the same. They can be changed be using the 
7& key for the transmit speed and 8* key for the receive 
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speed. For the CIT-5@@ terminal this option is changed by 
uSing the up and down arrows while in setup mode C. 


b. Parity has been enabled. 


The default parameter for parity on CIE systems has this 
option disabled. Therefore the terminal must also have 
this option disabled. The CIT-8@0 refers to this option as 
receiver parity check and must be turned off using the 6% 
key while in setup mode, field C, position 2. The CIT-1@1 
and 161 have this option located in setup mode B, group 4, 
position 2. Using the 6” key, change this option to 
DISABLE. The CIT-5@8 also refers to this option as 
receiver parity check which can be turned off by using the 
up or down arrow while in setup mode C, field B, position 
Ze 


Cc. X-ON / X-OFF Protocol has been disabled. 


In order to match the high speed of a computer to that of a 
terminal it is necessary to use some sort of protocol to 
control transmission. CIE uses the X-ON/X-OFF protocol 
which is also sometimes called DC1/DC3 (device control). 
When this condition occurs the information on the screen 
will be missing characters and/or line feeds and carriage 
returns. Another indication of disabled protocol can be a 
flashing on-line light located on the keyboard. The CIT-8@ 
has two setup mode fields for enabling X-ON/X-OFF protocol, 
Respond to X-ON/X-OFF is turned on in setup mode field D, 
position 1. Generate X-ON/X-OFF is turned on in setup mode 
field D, position 2 by using the 6* key. Both must be 
enabled for proper operation. To enable X-ON/X-OFF in the 
CIT-161 and CIT-161 enter setup mode B, group 2, position 4 
and using the 6” key turn this option on. For the CIT-590, 
respond to X-ON/X-OFF is located in setup mode C, field B, 
position 3. Generate X-ON/X-OFF is located in setup mode C, 
field B, position 4. Use the up or down arrow to enable 
these options. 


d. Wrong character length selected. 


NOTE: This condition does not apply to the CIT-8@ or 


The CIT-101 and 161 have a character length option located 
in setup mode B, group 4, position 3. Using the 6% key 
change the bits per character to equal 8. If this option 
is not set correctly, the terminal screen will display a 
large number of reverse video boxes. 
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e. Control characters are being displayed. 
NOTE: This condition does not apply to the CIT-8@ or 
CIT-500. 


If characters inside of a reverse video box are being 
displayed on the terminal display, these are control 
Characters. These characters are normally executed and 
should not be displayed. To correct this condition in the 
CIT-181 and 161 enter setup mode C, group 2, position 1 and 
uSing the 6” key change this control character option to 
executed. 


f. The data being displayed is corrupted. 


Although a remote possibility for an incorrect display, 

this should not be overlooked or ignored. If file system 
corruption is suspected please refer to the appropriate 

section in this manual. 


3. Cursor doesn't line feed when it reaches the end of screen 
at the right hand margin. 


a. Auto wrap is turned off. 
CAUTION: This option must be off for LEX users. 


The CIT-88 contains this option in field G, position 2. 
Using the 6° key, change this option to ON. For the CIT-161 
and 161 this option is found in setup mode B, group 3, 
position 2 and is also changed by the 6” key on the 
keyboard. For the CIT-588 enter setup mode C, field F, 
position 2 to change this option. 


4. Data being input at the keyboard is being displayed on the 
terminal screen twice. 


a. Terminal is in half duplex mode. 


There are two modes of transmission supported on CIT 
terminals. Half duplex indicates that the data will be 
displayed on the screen by the terminal prior to being 
transmitted to the computer. In full duplex (usually 
referred to as duplex) the data is sent 

to the computer first, and then returned to the terminal 
for display on the screen. Since CIE systems assumes a 
terminal will be connected in duplex mode, a character will 
display twice if the terminal is set incorrectly to half 
duplex mode (once by the terminal and again by the system). 
This option can be found on a CIT-8@ in field D position 3. 
Using the 6” key select DUPLEX. For the CIT-101 and 161 
select full duplex in setup mode C, group 4, position 2 
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uSing the 6* key. The CIT-5@@ contains this option in 
Setup mode C, field C, position 1 and can be changed by 
using the up or down arrow. 


5. System prompt is being displayed twice. Input data is being 
displayed normally. 


a. The new line option has been turned on. 


This option must be turned off for normal Operation. For 
the CIT-88 enter setup mode and position the cursor in 
field G, position 2. Using the 6* key, turn this option 
off. For the CIT-101 and 161, enter Setup mode B, group 3, 
position 3 and again using the 6% key, turn this option 
off. The CIT-580 locates this option in setup mode C, 
field F, position 1. Using the up or down arrow turn this 
option off. 


6. Characters being displayed appear to move (jitter). 
a. Screen frequency has been incorrectly set for 50 Hertz. 


The normal screen frequency for all terminals used in the 
United States should be 60 Hertz. The CIT-8@ refers to 

this option as line frenquency and is found in setup mode, 
field G, position 4. Use the 6* key to select 60 Hz. For 
the CIT-181 and 161 enter setup mode B, group 4, position 4 
and using the 6” key select 6@ Hz. The CIT-5@0 does not 
offer this option as it is preset at the factory. 
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INITIAL PROGRAM LOAD 


Initial Program Load (IPL) problems can be the most difficult to 
diagnose. Without an operating system we are restricted in the use 
of diagnostic tools. Software problem solving techniques are 
discussed in another section. However, the following are solutions 
to some hardware related IPL problems. 


1. Nothing happens when the IPL button is depressed. 


a. The system console may not have been set-up correctly. 
Please refer to the section on terminal set up. 


b. The system console may have been cabled to the wrong port. 
The system console must be connected to port @. The ports 
should be clearly labled on the rear of the CPU chassis. In 
the event that an incorrect labeling is suspected test the 
other ports by moving the console cable and depressing the 
IPL switch. A successful connection will result in the 
following message being displayed on the terminal screen: 


Please specify boot device 


Cc. The IPL cable which connects the IPL switch to the CPU board 
may have been dislodged. A two conductor cable with a 
small connecter on one end should be securely attached to 
the CPU board just to the side of the CPU status lights. 
The connector is keyed and cannot be installed 
incorrectly. 


d. A hardware malfunction may have occurred such as a broken 
IPL switch or a CPU failure. If the problem cannot be 
corrected by one of the previous suggestions it will be 
necessary to contact CIE Systems for repair or replacement 
of the failed unit. 


2. System performs selftest correctly, exits IPL boot program, 
then enters debug mode. 


a. Peripheral box has not been powered up. When the enclosure 
1s powered correctly a red indicator light is clearly 
visible on the front of the unit. 


b,. The Winchester disk has not reached operating speed. A few 
Minutes are required for the disk unit to reach operating 
speed. In the event the system has been powered off for a 
time (cold start) a brief 1@ minute warm up should be 
performed. In either case, after the required time has 
elapsed you must press the IPL button. 


CIE SYSTEMS REGULUS 7 SYSTEM ADMINISTRATOR'S MANUAL 


Hardware Trouble Shooting Guide 


c. Peripheral cables are not installed correctly or are not 
making good contact. The Winchester disk requires a data 
cable for each drive and a control cable which is daisy 
chained between the units. The connections are located on 
the back of the CPU enclosure and the peripheral enclosure. 
The cables are of two different sizes and cannot be 
installed incorrectly. However, it is very important that 
the cables are seated completely and securely to avoid any 


intermittent problems. All cable connections are clearly 
labled. 


3. System performs selftest correctly but never exits IPL boot 
program. System is hung. 


a. Attempt was made to boot from a newly formated disk. 
Since the system can't exit the IPL boot program it becomes 


apparent that the boot program is either missing or 
corrupted. 


b. Operating system has been corrupted or destroyed. 


on 
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DISKETTE DRIVE 
After inserting a diskette the drive door won't close. 


The diskette drive door is equiped with a safety feature which 
prevents the door being closed when a diskette is not installed 
completely. Reinstall the diskette correctly. 


Unable to load data from the diskette drive. 


There are a number of things that can cause problems when reading or 
writing to any peripheral device. However, before attempting any 
trouble shooting, the system exerciser should be run to verify that a 
malfunction does exist. The system should be visually inspected to 
see if any cables are not connected properly or are damaged. The 
following are some malfunctions that can occur. 


If the drive's heads load (there is an audible click when this 
occurs) but data is not being loaded, one of the following may be 
in effect: 


1. Drive heads are dirty. 


As with any recording device the read/write heads must be 
kept clean to insure maximum efficiency. Since the heads are 
not directly accessible, it will be necessary to purchase a 
head cleaning device available at most data processing 
supply stores. Clean the heads in accordance with the 
instructions supplied with the cleaning device. 


2. Media is faulty. 


The diskette is a very sensitive recording media which 
requires a great amount of care. Sometimes proper handling 
techniques are not observed and a diskette may become 
faulty. If problems are being experienced try using another 
diskette. 


3. Diskette is not formatted. 


When a diskette is used that has not been formatted the read/ 
write heads inside the drive will click as the heads load 

and unload. This clicking will continue as long as the 
diskette is left in the drive. Please make sure that the 
diskette is formatted for 512 bytes per sector before any 
attempt is made to use the diskette. 


4. Diskette was write protected when data was written. 
It is possible to have either a blank diskette or a diskette 
with old data instead of new if the diskette had a write 


protect tab in place. Rewrite data to the diskette without a 
write protect tab on the diskette. 
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5. Heads out of alignment. 


This problem becomes evident when read or write problems 
occur when diskettes are interchanged between diskette 
drives. This alignment should be performed by a qualified 
service technician only. 


When trying to read data from a diskette, if the heads don't load, a 
device address jumper located on the printed circuit board of the 
diskette drive may have become dislodged. If an attempt was made to 
IPL from diskette at this time the system would have entered debug, 
the resident mirco diagnostic program contained on the central 
processor unit (CPU). 


Viewing the drive from the rear, locate two rows of gold pins in 
the lower left corner of the unit. There should be two white 
jumpers installed. One at location HM and one at DS@. The above 
problem occurs if the HM jumper is missing. 
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PRINTER 


A peripheral that may require trouble shooting is the printer. 
Printers are of two types, parallel and serial. Although they perform 
the same function, the means for communicating with the system are 
quite different. Very little can go wrong when configuring a parallel 
printer. The only caution is to ensure the correct cabling to the 
parallel printer port on the system. All software setup options are 
performed by the lpconfig utility and any questions can be answered 
by the online documentation for lpconfig. The rest of this section 
will cover the model 68PTR-8315 serial printer with an assumed 
Operating speed of 9680 baud (960 characters per second). This 
section must be used in conjunction with the CI-3518 User's Manual. 
Some problems that can be resolved are: 


1. Printer doesn't print at all. 
a. Printer is not powered up. Power up Printer. 
b. Printer was not powered up when the IPL button was depressed. 


One of the functions of REGULUS is to identify the hardware 
connected to the system. If the printer was not powered up 
when the system was IPL'd, REGULUS assumes it isn't there, 
The solution is to IPL the system with the printer powered up 
and correctly cabled to the system. 


Cc. Printer is connected to wrong port. 


A serial printer would usually be connected to the last 
available port on the system. In the case of a 680/20 
logical port 3 would be used. If it is not certain which 
port has been set up for the printer, the /etc/ttys file 
will need to be accessed. After entering " cat /etc/ttys ", 
find the line which has @ as the first entry. This will be 
the port that has had logins disabled, which are not 
neccessary for a printer. The number following the @ will be 
the logical port number. For example the entry for a printer 
connected to logical port 3 operating at 9600 baud would 
appear as 031. The 1 indicates 9600 baud operation. If no 
entry exists, follow the instructions for using the lpconfig 
utility found in the online documentation. 


d. Cable is wrong type. 
The cable to connect the printer directly to a serial port of 
the system should have 68CB1-YYYY stamped on it. The cable to 
use when the printer will be connected to a terminal as an 
auxiliary device is a 68CB5-YYYY. YYYY is the cable length. 


2. Printer double line feeds. 


Incorrect carriage return function selected. 
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Since REGULUS appends a line feed to each carriage return, 
the printer should be configured to perform a carriage 
return only. This is accomplished by selecting option 1 in 
field number 26 of the printer. Detailed instructions for 
identifying and changing field values can be found in the 
printers user's manual. 


3. Printer is printing nonsense. 


ae 


Character string length is incorrect. 


The correct character string length is 8 data bits per 
character. A value of 8 in field 52 selects 8 data bits. 


Wrong character set selected. 


CIE printers have the ability to print in many different 
languages. Ensure that fields 41, 42, 43, and 44 have option 
2 (US ASCII) selected. 


Parity has been enabled. 


The normal set up for parity is to have it disabled. This is 
done in field 53 by a value of 1. 


Incorrect stop bit setting. 


CIE Systems use 1 stop bit. This is selected in field 54 by 
option 2, 


Incorrect baud rate selection. 


The baud rate selected in the printer must match the baud 
rate set up in REGULUS. The baud rate is selected in field 
Sl. Option 1 sets the printer to 9600 baud. 


An attempt was made to print when the system was in 
Single user mode, 


Unless the system is in multi-user mode all RS232-C ports 
are disabled except port @. The system automatically enters 
multi-user mode at IPL time if the file system is in order. 
A simple way to check the system is to log on a terminal 
Other than the console. This cannot be done while in Single 
user mode. 


4. Top of form is not lining up. 


The page length is calculated in 24ths of an inch. The 
default setting of 264 in field 16 is for a page length 
of 66 lines (11 inches). 
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5. The printer is not printing bidirectionaly. 


The selection of bidirectional printing can be done by 
enabling option 1 in field 34. 


6. The printer is losing characters. 
Incorrect protocol set-up. 


The normal protocol is X-ON (DCl) X-OFF (DC3). This protocol 
is selected by option 4 in field 5@. 


Direct Connect Serial Printer Software Trouble Shooting 


When serial printers are connected to an asynchronous communication 
port a number of considerations have to be made regarding the format 
of the serial character, the RS232-C interface standard, and the type 
of protocol used. Before attempting any trouble shooting in REGULUS 
be sure that the following options are selected in the printer. 


X-ON/XOFF Protocol Selected 

8 Bit Character Length Selected 
Parity Disabled 

1 Stop Bit Selected 

9680 Baud Rate Selected 


lpconfig 


lpconfig is a utility which performs all the software setup functions 
to REGULUS for configuring a printer. Although the utility will 
configure for either a parallel or serial printer, our discussion 
here is limited to the serial printer. For a detailed description 

on the lpconfig utility please refer to your online documentation. 


To configure a serial printer operating at 9608 baud connected to 
port 3 enter the following: 


Type: lpconfig -s lp 3 9600 
Press: <return> 


The following information can be used to interrogate the operating 
system and verify that lpconfig performed correctly. 


stty 
In addition to hardware options in the printer, similiar options 


needed to be set in REGULUS. lpconfig used the stty command to 
configure the selected port for the correct baud rate as well as 
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enable the X-ON/X-OFF protocol. To verify the stty configuration for 
port three enter the following: 


Type: stty -a < /dev/tty3 
Press: <return> 


and ensure that the following high lighted options are selected for 
the particular port, in this example port 3. 


Control Modes: =parenb -parodd cs8 9689 -hubcl -hub -cstopb -cread 
Clocal -exopen 

Input Modes: -ignbrk -brkint -ignpar -inpck istrip -inclr -igncr 
icrnl -iuclc ixon ixany ixoff 

Output Modes: opost -olcuc -ocrnl -onocr -onlret onlcr -ofill 
-Ofdel cr@ nl@ tab3 bs@ ffFO vtd 

Local Modes: regulus tabset 4 isig echo echoe ledit 

Control Assignments: erase '“H' kill '“U' intr '*?' quit '*\' eof 
“Dp! eol “yz! 


For a detailed description of the above mnemonics see appendix A. 


/etc/ttys 


The file /etc/ttys is used to inform the system about asynchronous 
devices such as terminals and printers. It is an ASCII file of lines, 
three characters each. The characters are positional and for the 
purpose of our example have the following meanings: 


1. The first character determines the state of logins for the 


specified device. A @ indicates that the logins are disabled. A l 
indicates that logins are enabled and that ‘init' will be created 
to wait on this device to become ready. Since a printer cannot 


login, lpconfig will use the setport command and set this entry to 
0. 


2. The second character is a number between @ and f (hex) indicating 
the logical port number (ie. the fourth port on a system is tty3). 


3. The last character defines the type of terminal and line this 
device is connected to. Since a @ was specified in position 1 this 


field wil be ignored. The control mode for the specified stty will 
contain the baud rate. 


For a detailed description of /etc/ttys see appendix B. 
setport 


Ssetport allows a super-user to configure the /etc/ttys file to enable 
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and disable asynchronous ports. If the /etc/ttys file was not disabled 
uSing the lpconfig utility as stated earlier, enter the following: 


Type: setport 3 -d 

Press: <return> 
The entry for port 3 in /etc/ttys should now appear as @31. 
/dev/lp 


If the serial printer is to be used as the spooling device an 
appropriate entry must exist in the REGULUS device table. To view the 
table enter the following command while logged into the system as 
superuser : 


Type: ls -1 /dev/lp 
Press: <return> 


For the serial printer (assuming the printer is connected to port 
three) the entry for device lp should appear as: 


Crw-rYw-rw=- root 1 Sat May 5 17:38 1984 @, 3 lp 


The date and time in the above example tell when the node was 
created. If the entry for /dev/lp is not as described above the 
lpconfig utility needs to be executed. 


The appropriate entry for /dev/lp should now appear as previously 
described. 


Auxiliary Printer Software Trouble Shooting 


There 1s no actual software set up required for connecting a serial 
printer to a terminal. The terminal will handle the interface between 
the computer and the printer. However, the terminal has to be 
configured in its set up mode to access the printer. In the case of a 
CIT-1901 or CIT-161 set up mode D should be as follows: 


Parity: Odd 

Parity: Disable 

Bits Per Character: 8 

Incoming XOFF (“S): Enable 

Fill After: CR 

Non-Fill Character (CR or LF): Transmit 
Auto XON-XOFF: On 

8th Bit on Transmit: Space 

Stop Bits on Transmit: 1 

Output Page Termination: None 
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Output Page Extent: Full Screen 
Fill=@ 

PT SPD 9600 

P R SPD 9600 


If it is not possible to enter set up mode D using the set up key on 
the keyboard, enter set up mode B and depress the X key while 
depressing the CTRL (control) key. This will enable set up mode D. 


Since the CIT-8@ uses a unidirectional auxiliary port the set up is 
much simpler. The correct set up should be: 


AUX PORT SPEED: 96900 
MAIN/AUX PARITY: SPACE 
RCVR PARITY CHECK: OFF 
RESPOND TO XON/XOFF: YES 
GENERATE XON/XOFF: YES 
MODE: ANSI 


Note: The CIT-88 does not offer a " bits per character " option. 
Therefore the serial printer must be set for a character 
length of 7 bits. This is accomplished by changing field 52 to 
a value of 7. 
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APPENDIX A 
stty - Set Terminal Characteristics 
stty [-a] [-g] [options] 


"Stty" sets the options given in its argument list on its current output 
file. 


If no arguments exist, 'stty' reports the status 
of the options of its current option file. 


If the -a option is given, all options are reported, otherwise only 
selected options are given. 


If the -g option is given, the output is formatted so that it 
May be used as an argument to another stty command. 


The following options are recognized by stty, those that are preceeded 
by '(-)' will also be recognized as ‘-option' to turn that option off. 


Control Modes (depending upon hardware) : 


) @ baud (hang up) 
50 50 baud 

75 75 baud 

11d 118 baud 

134 134.5 baud 

15d 15@ baud 

200 208 baud 

300 300 baud 

600 600 baud 

1200 1200 baud 

1800 1880 baud 

2490 2480 baud 

4800 4800 baud 

9600 96800 baud 

19280 19200 baud 

38400 38400 baud 

exta External A (19200 baud) 
extb External B (384800 baud) 
cs5 5 bit characters 
cs6 6 bit characters 
cs7 7 bit characters 
cs8 8 bit characters 
(-)parenb enable parity 


(-)parodd select odd parity 
(-—) hupel hang up on last close 


(-—) hup same as hupcl 
(-)cstopb use two stop bits per character 
(-) cread enable reciever 


(—) clocal enable modem control 
(-)exopen exclusive open only 
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Input Modes: 


(-—) ignbrk 
(-) brkint 
(—) ignpar 
(-) parmrk 
(-) inpck 
(-) istrip 
(-—) inlcr 
(-) igncr 
(—) icrnl 
(~) iucle 
(-—) ixon 
(—) 1xany 
(~) ixoff 


Output Modes: 


(-) opost 
(~) olcuc 
(-—) onlcr 
(-) ocrnl 
(—) onocr 
(-)onlret 
(-)ofill 
(-) ofdel 
crg 

crl 

cr2 

cr3 

nlg 

nll 

tabd 
tabl 
tab2 


ignore break on input 

Signal INTR on break 

ignore parity errors 

Mark parity errors 

enable input parity checking 

strip input characters to seven bits 
map NL to CR on input 

ignore CR on input 

map CR to NL on input 

map upper-case to lower case on input 
enable START/STOP output control 
allow any character to restart stopped output 
enable START/STOP input control 


post-process output 

map lower-case to upper-case on output 
map NL to CR=-LF on output 

map CR to NL on output 

do not output CR at column zero 
NL performs CR function 

use fill characters for delay 
fill character is DEL (NUL) 

no carriage return delay 

delay of approximately .10 sec 
delay of approximately .20 sec 
delay of approximately .38@ sec 
no line feed delay 

delay of approximately .10 sec. 
no tab delay or translation 
delay of approximately .18 sec. 
delay of approximately .20 sec. 
translate tabs to spaces 
translate tabs to spaces 

no backspace delay 

delay of approximately .18 sec. 
no form feed delay 

delay of approximately .10 sec. 


no vertical tab delay 


delay of approximately .10 sec. 


Regulus line editor modes: 


(—) ledit 
(—) echo 
(~) echoe 
(—) echok 
(-)isig 
(—) noflsh 
tabset 'n’' 
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Standard Unix Line Discipline (Not implemented) 


(-) isig enable INTR and QUIT processing 

(-—) icanon enable canonical input processing 

(-) xcase canonical upper/lower case processing 
(-) echo echo every character typed 

(~) echoe echo erase as BS-SP-BS 

(—) echok echo kill as NL 

(-) lfke same as echok 

(—) echonl echo NL if echo turned off 

(-) noflsh do not flush after INTR or QUIT 


Control Assignments: 


erase ‘c' set eraSe character to ‘'c‘', control 
characters may be specified by "“x" to 
get CNTRL-X. ."°?" is DEL (a.k.a. Rubout) 
and "“-" is undefined. 


kill ‘c' set kill character to 'c' 

intr ‘c' set interrupt character to 'c' 

quit 'c' set quit character to 'c' 

eof ‘c' set end of file character to ‘'c' 

eol ‘c' set end of line character to '‘'c' 

min ‘n' set min characters read to 'n', @ <= n < 127 

time ‘n' set timeout to 'n' 

line 'n!' set line discipline to 'n', @ = Unix, 1 = REGULUS 
unix set line discipline for Unix line discipline 
regulus set line discipline for REGULUS line discipline 


Aggregate Modes: 
Aggregate Modes: 


even (p) parenb + -parodd + cs7 

-even (p) -parenb + cs8 

odd (p) parenb + parodd + cs7 

-odd (p) -parenb + cs8 

parity parenb + -parodd + cs7 

-parity -parenb + cs8 

raw -icanon + -isig 

-raw icanon + iSig (cooked) 

cooked icanon + isig 

-cooked -icanon + -isig 

cbreak -icanon + isig (EOF character is not processed) 
~cbreak icanon + isig (cooked) 

lcase -iuclc + -olcuc 

LCASE -luclc + -olcuc 

-lcase luclc + olcuc 

-~LCASE iuclce + olcuc 

nl -icrnl + -onlcr 

-nl icrnl + onlcr + -inlcr + -igncr + -ocrnl 
sane set tty settings to something ‘reasonable’ 
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APPENDIX B 
ttys - /etc/ttys format 
The file ‘/etc/ttys' is used to inform the system about terminals 
(tty's ). It is an ascii file of lines of three characters each. The 
characters are positional and have the following meanings: 


CHAR VALUES MEANINGS 


1 The first character determines the state of logins 
for the specified terminal (see character 2). 


Gg Terminal is disabled. Logins are not allowed, 
and no ‘init' will be started for this 
terminal. 

1 Terminal is enabled. A copy of ‘init' will be 


created to wait on this terminal to become 
ready. A terminal is assumed to be ready when 
an open on the device succeeds. 


J 


Terminal is draining. A new copy of ‘init' 

will not be started when the current process 

running on this terminal is ended. This has the 

effect of 'draining' the users off the system, a 
Since new logins are prohibited when old users 

log out. Any character other than '@' or '1l' is 


allowed. 
2 The second character indicates the port number of the device. 
Only alphabetic or Single numeric characters are allowed. 
3 The last character defines the type of terminal and line this 
device is connected to. The types are as follows: 
Gg CIT-88 or VT-52 type terminal at 9600 baud. 
1 CIT-10@8 or VT-101 type terminal at 9600 baud. 
2 388 baud dial-in line. 
3 1280 baud dial-in line. 
4 1280-388 baud cycling line. The line will be 


tried first at 1200 baud. If a break is 
detected, the line is reset to 300 baud and 
tried. This loop continues until a line is 
successfully read. 


5 308-1200 baud cycling line. This is the same oe 
as '4' above, except that 300 baud is tried 
first. 
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6 4800 baud. 
7 2400 baud. 
8 600 baud. 
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